@clawplays/ospec-cli 0.1.1

package/dist/services/TemplateGenerator.js

@@ -0,0 +1,273 @@
+"use strict";
+/**
+ * 模板生成服务
+ * 负责生成 proposal.md、tasks.md、verification.md 等模板文件
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TemplateGenerator = void 0;
+const FileService_1 = require("./FileService");
+const SkillParser_1 = require("./SkillParser");
+const constants_1 = require("../core/constants");
+class TemplateGenerator {
+    /**
+     * 生成 proposal.md 模板
+     */
+    static generateProposalTemplate(featureName, affects = []) {
+        const now = new Date().toISOString().split('T')[0];
+        return `---
+name: ${featureName}
+status: active
+created: ${now}
+affects: [${affects.map((a) => `"${a}"`).join(', ')}]
+flags: []
+---
+
+## 背景
+
+为什么要做这个 feature？当前存在哪些问题？
+
+## 目标
+
+做完之后能解决什么问题？用户或开发者能得到什么？
+
+## 范围
+
+**涉及：**
+- 列出涉及的模块或文件
+
+**不涉及：**
+- 列出明确不在本次范围内的内容，避免范围蔓延
+
+## 验收标准
+
+- [ ] 条件一
+- [ ] 条件二
+`;
+    }
+    /**
+     * 生成 tasks.md 模板
+     */
+    static generateTasksTemplate(featureName, coreRequiredSteps = [], optionalSteps = []) {
+        const now = new Date().toISOString().split('T')[0];
+        let content = `---
+feature: ${featureName}
+created: ${now}
+optional_steps: [${optionalSteps.map((s) => `"${s}"`).join(', ')}]
+---
+
+## 任务清单
+
+### 核心任务
+
+`;
+        // 添加核心任务
+        if (coreRequiredSteps.length > 0) {
+            coreRequiredSteps.forEach((step, index) => {
+                content += `- [ ] ${index + 1}. ${step}\n`;
+            });
+        }
+        else {
+            content += `- [ ] 1. 实现功能\n`;
+            content += `- [ ] 2. 更新文档\n`;
+            content += `- [ ] 3. 更新索引\n`;
+            content += `- [ ] 4. 运行测试\n`;
+        }
+        // 添加可选任务
+        if (optionalSteps.length > 0) {
+            content += `\n### 可选任务\n\n`;
+            optionalSteps.forEach((step, index) => {
+                content += `- [ ] ${index + 1}. ${step}\n`;
+            });
+        }
+        return content;
+    }
+    /**
+     * 生成 verification.md 模板
+     */
+    static generateVerificationTemplate(featureName, optionalSteps = []) {
+        const now = new Date().toISOString().split('T')[0];
+        let content = `---
+feature: ${featureName}
+created: ${now}
+optional_steps: [${optionalSteps.map((s) => `"${s}"`).join(', ')}]
+---
+
+## 验证清单
+
+### 自动验证
+
+- [ ] 编译成功
+- [ ] 代码检查通过
+- [ ] 测试通过
+
+### 需求验收
+
+- [ ] 功能实现完整
+- [ ] 符合验收标准
+
+### 文档更新
+
+- [ ] 相关模块 SKILL.md 已更新
+- [ ] SKILL.index.json 已重建
+
+`;
+        if (optionalSteps.length > 0) {
+            content += `### 可选步骤验证\n\n`;
+            optionalSteps.forEach((step) => {
+                content += `- [ ] ${step} 已完成\n`;
+            });
+            content += `\n### 通过的可选步骤\n\npassed_optional_steps: []\n`;
+        }
+        content += `\n### 通过条件\n\n所有验证项都通过后，可以进入归档阶段。\n`;
+        return content;
+    }
+    /**
+     * 生成 state.json 内容
+     */
+    static generateStateJson(featureName, affects = [], mode = 'standard') {
+        return {
+            version: '1.0',
+            feature: featureName,
+            mode,
+            status: 'draft',
+            current_step: 'write_proposal',
+            affects,
+            completed: [],
+            pending: [
+                'proposal_complete',
+                'tasks_complete',
+                'implementation_complete',
+                'skill_updated',
+                'index_regenerated',
+                'tests_passed',
+                'verification_passed',
+                'archived',
+            ],
+            blocked_by: [],
+            last_updated: new Date().toISOString(),
+        };
+    }
+    /**
+     * 创建 feature 目录和文件
+     */
+    static async createFeatureDirectory(projectRoot, featureName, affects = [], coreRequiredSteps = [], optionalSteps = []) {
+        const featurePath = FileService_1.FileService.joinPath(projectRoot, 'changes', 'active', featureName);
+        // 创建目录
+        await FileService_1.FileService.createDirectory(featurePath);
+        // 生成 proposal.md
+        const proposalContent = this.generateProposalTemplate(featureName, affects);
+        await FileService_1.FileService.writeFile(FileService_1.FileService.joinPath(featurePath, constants_1.FILE_NAMES.PROPOSAL), proposalContent);
+        // 生成 tasks.md
+        const tasksContent = this.generateTasksTemplate(featureName, coreRequiredSteps, optionalSteps);
+        await FileService_1.FileService.writeFile(FileService_1.FileService.joinPath(featurePath, constants_1.FILE_NAMES.TASKS), tasksContent);
+        // 生成 verification.md
+        const verificationContent = this.generateVerificationTemplate(featureName, optionalSteps);
+        await FileService_1.FileService.writeFile(FileService_1.FileService.joinPath(featurePath, constants_1.FILE_NAMES.VERIFICATION), verificationContent);
+        // 生成 state.json
+        const stateJson = this.generateStateJson(featureName, affects);
+        await FileService_1.FileService.writeJSON(FileService_1.FileService.joinPath(featurePath, constants_1.FILE_NAMES.STATE), stateJson);
+    }
+    /**
+     * 生成项目初始化文件
+     */
+    static async initializeProject(projectRoot, mode = 'lite') {
+        // 创建必要的目录
+        await FileService_1.FileService.createDirectory(FileService_1.FileService.joinPath(projectRoot, 'changes', 'active'));
+        await FileService_1.FileService.createDirectory(FileService_1.FileService.joinPath(projectRoot, 'changes', 'archived'));
+        await FileService_1.FileService.createDirectory(FileService_1.FileService.joinPath(projectRoot, 'for-ai'));
+        await FileService_1.FileService.createDirectory(FileService_1.FileService.joinPath(projectRoot, 'docs'));
+        // 生成 SKILL.md
+        const skillContent = SkillParser_1.SkillParser.createDefaultSkill('project', ['project', 'root'], 'Project Root');
+        await FileService_1.FileService.writeFile(FileService_1.FileService.joinPath(projectRoot, constants_1.FILE_NAMES.SKILL_MD), skillContent);
+        // 生成 ai-guide.md
+        const aiGuideContent = this.generateAiGuide();
+        await FileService_1.FileService.writeFile(FileService_1.FileService.joinPath(projectRoot, 'for-ai', 'ai-guide.md'), aiGuideContent);
+        // 生成 execution-protocol.md
+        const executionProtocolContent = this.generateExecutionProtocol();
+        await FileService_1.FileService.writeFile(FileService_1.FileService.joinPath(projectRoot, 'for-ai', 'execution-protocol.md'), executionProtocolContent);
+    }
+    /**
+     * 生成 AI 指南
+     */
+    static generateAiGuide() {
+        return `# AI 指南
+
+> OSpec 规范 v3.0
+
+## 项目概览
+
+本项目使用 ospec 规范管理需求和工作流。
+
+## 关键文件
+
+- \`.skillrc\` - 项目配置
+- \`SKILL.md\` - 项目文档
+- \`changes/active/\` - 活跃的 feature
+- \`changes/archived/\` - 已归档的 feature
+
+## 开发流程
+
+1. 创建 feature（proposal.md）
+2. 启动 feature（生成 tasks.md）
+3. 实现功能
+4. 若涉及 Stitch 安装、provider 切换、MCP 或认证配置，优先读取仓库内 Stitch 规范；若缺失规范文档，则使用内建基线：Gemini 用 \`%USERPROFILE%/.gemini/settings.json\` 的 \`mcpServers.stitch.httpUrl\` 与 \`headers.X-Goog-Api-Key\`，Codex 用 \`%USERPROFILE%/.codex/config.toml\` 的 \`[mcp_servers.stitch]\`、\`type = "http"\`、\`url = "https://stitch.googleapis.com/mcp"\` 与 \`X-Goog-Api-Key\`
+5. 若内建 Codex provider 只读调用正常但 Stitch 写操作卡住，优先检查是否真正走了 \`codex exec --dangerously-bypass-approvals-and-sandbox\`
+6. 更新文档和索引
+7. 验证
+8. 归档
+
+## 常见命令
+
+\`\`\`bash
+# 创建 feature
+ospec feature create my-feature
+
+# 启动 feature
+ospec feature start my-feature
+
+# 查看状态
+ospec feature status my-feature
+
+# 归档 feature
+ospec feature archive my-feature
+\`\`\`
+`;
+    }
+    /**
+     * 生成执行协议
+     */
+    static generateExecutionProtocol() {
+        return `# AI 执行协议
+
+> OSpec 规范 v3.0
+
+## 每次进入项目时必须先读
+
+1. \`.skillrc\`
+2. \`SKILL.index.json\`
+3. 当前 feature 的 \`proposal.md\`
+4. 当前 feature 的 \`tasks.md\`
+5. 当前 feature 的 \`state.json\`
+6. 当前 feature 的 \`verification.md\`
+
+## 强制规则
+
+- 没有 \`proposal.md\` 不得开始实现
+- 没有 \`tasks.md\` 不得开始实现
+- 没有 \`verification.md\` 不得 archive
+- \`verification.md\` 未通过不得 archive
+- 若涉及 Stitch provider、MCP 或认证配置，优先读取仓库内 Stitch 规范；若缺失规范文档，则使用内建基线：Gemini 用 \`%USERPROFILE%/.gemini/settings.json\` 的 \`mcpServers.stitch.httpUrl\` 与 \`headers.X-Goog-Api-Key\`，Codex 用 \`%USERPROFILE%/.codex/config.toml\` 的 \`[mcp_servers.stitch]\`、\`type = "http"\`、\`url = "https://stitch.googleapis.com/mcp"\` 与 \`X-Goog-Api-Key\`
+- 若内建 Codex provider 只读调用正常但 Stitch 写操作卡住，优先检查是否真正走了 \`codex exec --dangerously-bypass-approvals-and-sandbox\`
+
+## 会话恢复规则
+
+每次新会话恢复时：
+
+1. 优先读取 \`state.json\`
+2. 以 \`state.json.status\` 为当前执行依据
+3. 不依赖对话记忆判断"已经做到哪一步"
+`;
+    }
+}
+exports.TemplateGenerator = TemplateGenerator;
+//# sourceMappingURL=TemplateGenerator.js.map

package/dist/services/ValidationService.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 验证服务
+ */
+export declare class ValidationService {
+    /**
+     * 验证变更名称格式
+     */
+    validateFeatureName(name: string): boolean;
+    /**
+     * 验证JSON格式
+     */
+    validateJSON(content: string): boolean;
+    /**
+     * 验证必填字段
+     */
+    validateRequiredFields(data: Record<string, any>, fields: string[]): boolean;
+}
+export declare const validationService: ValidationService;
+//# sourceMappingURL=ValidationService.d.ts.map

package/dist/services/ValidationService.js

@@ -0,0 +1,44 @@
+"use strict";
+/**
+ * 验证服务
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validationService = exports.ValidationService = void 0;
+const errors_1 = require("../core/errors");
+class ValidationService {
+    /**
+     * 验证变更名称格式
+     */
+    validateFeatureName(name) {
+        const regex = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+        if (!regex.test(name)) {
+            throw new errors_1.ValidationError(`Invalid change name: ${name}`);
+        }
+        return true;
+    }
+    /**
+     * 验证JSON格式
+     */
+    validateJSON(content) {
+        try {
+            JSON.parse(content);
+            return true;
+        }
+        catch (error) {
+            throw new errors_1.ValidationError('Invalid JSON format');
+        }
+    }
+    /**
+     * 验证必填字段
+     */
+    validateRequiredFields(data, fields) {
+        const missing = fields.filter(field => !data[field]);
+        if (missing.length > 0) {
+            throw new errors_1.ValidationError(`Missing required fields: ${missing.join(', ')}`);
+        }
+        return true;
+    }
+}
+exports.ValidationService = ValidationService;
+exports.validationService = new ValidationService();
+//# sourceMappingURL=ValidationService.js.map

package/dist/services/Validator.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 验证服务
+ * TODO: 实现规范校验
+ */
+//# sourceMappingURL=Validator.d.ts.map

package/dist/services/Validator.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * 验证服务
+ * TODO: 实现规范校验
+ */
+//# sourceMappingURL=Validator.js.map

package/dist/services/index.d.ts

@@ -0,0 +1,52 @@
+/**
+ * 服务层导出
+ */
+export { FileService, fileService } from './FileService';
+export { ConfigManager, createConfigManager } from './ConfigManager';
+export { StateManager, createStateManager } from './StateManager';
+export { SkillParser, skillParser } from './SkillParser';
+export { TemplateEngine, templateEngine } from './TemplateEngine';
+export { ValidationService, validationService } from './ValidationService';
+export { Logger, LogLevel, logger } from './Logger';
+export { IndexBuilder, createIndexBuilder } from './IndexBuilder';
+export { ProjectAssetService, createProjectAssetService } from './ProjectAssetService';
+export { ProjectScaffoldService, createProjectScaffoldService } from './ProjectScaffoldService';
+export { ProjectScaffoldCommandService, createProjectScaffoldCommandService, } from './ProjectScaffoldCommandService';
+export { ProjectService, createProjectService } from './ProjectService';
+export { QueueService, createQueueService } from './QueueService';
+export { RunService, createRunService } from './RunService';
+import { FileService } from './FileService';
+import { ConfigManager } from './ConfigManager';
+import { StateManager } from './StateManager';
+import { SkillParser } from './SkillParser';
+import { TemplateEngine } from './TemplateEngine';
+import { ValidationService } from './ValidationService';
+import { Logger } from './Logger';
+import { IndexBuilder } from './IndexBuilder';
+import { ProjectAssetService } from './ProjectAssetService';
+import { ProjectScaffoldService } from './ProjectScaffoldService';
+import { ProjectScaffoldCommandService } from './ProjectScaffoldCommandService';
+import { ProjectService } from './ProjectService';
+import { QueueService } from './QueueService';
+import { RunService } from './RunService';
+export declare class ServiceContainer {
+    private static instance;
+    readonly fileService: FileService;
+    readonly configManager: ConfigManager;
+    readonly stateManager: StateManager;
+    readonly skillParser: SkillParser;
+    readonly templateEngine: TemplateEngine;
+    readonly validationService: ValidationService;
+    readonly logger: Logger;
+    readonly indexBuilder: IndexBuilder;
+    readonly projectAssetService: ProjectAssetService;
+    readonly projectScaffoldService: ProjectScaffoldService;
+    readonly projectScaffoldCommandService: ProjectScaffoldCommandService;
+    readonly projectService: ProjectService;
+    readonly queueService: QueueService;
+    readonly runService: RunService;
+    private constructor();
+    static getInstance(): ServiceContainer;
+}
+export declare const services: ServiceContainer;
+//# sourceMappingURL=index.d.ts.map

package/dist/services/index.js

@@ -0,0 +1,91 @@
+"use strict";
+/**
+ * 服务层导出
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.services = exports.ServiceContainer = exports.createRunService = exports.RunService = exports.createQueueService = exports.QueueService = exports.createProjectService = exports.ProjectService = exports.createProjectScaffoldCommandService = exports.ProjectScaffoldCommandService = exports.createProjectScaffoldService = exports.ProjectScaffoldService = exports.createProjectAssetService = exports.ProjectAssetService = exports.createIndexBuilder = exports.IndexBuilder = exports.logger = exports.LogLevel = exports.Logger = exports.validationService = exports.ValidationService = exports.templateEngine = exports.TemplateEngine = exports.skillParser = exports.SkillParser = exports.createStateManager = exports.StateManager = exports.createConfigManager = exports.ConfigManager = exports.fileService = exports.FileService = void 0;
+var FileService_1 = require("./FileService");
+Object.defineProperty(exports, "FileService", { enumerable: true, get: function () { return FileService_1.FileService; } });
+Object.defineProperty(exports, "fileService", { enumerable: true, get: function () { return FileService_1.fileService; } });
+var ConfigManager_1 = require("./ConfigManager");
+Object.defineProperty(exports, "ConfigManager", { enumerable: true, get: function () { return ConfigManager_1.ConfigManager; } });
+Object.defineProperty(exports, "createConfigManager", { enumerable: true, get: function () { return ConfigManager_1.createConfigManager; } });
+var StateManager_1 = require("./StateManager");
+Object.defineProperty(exports, "StateManager", { enumerable: true, get: function () { return StateManager_1.StateManager; } });
+Object.defineProperty(exports, "createStateManager", { enumerable: true, get: function () { return StateManager_1.createStateManager; } });
+var SkillParser_1 = require("./SkillParser");
+Object.defineProperty(exports, "SkillParser", { enumerable: true, get: function () { return SkillParser_1.SkillParser; } });
+Object.defineProperty(exports, "skillParser", { enumerable: true, get: function () { return SkillParser_1.skillParser; } });
+var TemplateEngine_1 = require("./TemplateEngine");
+Object.defineProperty(exports, "TemplateEngine", { enumerable: true, get: function () { return TemplateEngine_1.TemplateEngine; } });
+Object.defineProperty(exports, "templateEngine", { enumerable: true, get: function () { return TemplateEngine_1.templateEngine; } });
+var ValidationService_1 = require("./ValidationService");
+Object.defineProperty(exports, "ValidationService", { enumerable: true, get: function () { return ValidationService_1.ValidationService; } });
+Object.defineProperty(exports, "validationService", { enumerable: true, get: function () { return ValidationService_1.validationService; } });
+var Logger_1 = require("./Logger");
+Object.defineProperty(exports, "Logger", { enumerable: true, get: function () { return Logger_1.Logger; } });
+Object.defineProperty(exports, "LogLevel", { enumerable: true, get: function () { return Logger_1.LogLevel; } });
+Object.defineProperty(exports, "logger", { enumerable: true, get: function () { return Logger_1.logger; } });
+var IndexBuilder_1 = require("./IndexBuilder");
+Object.defineProperty(exports, "IndexBuilder", { enumerable: true, get: function () { return IndexBuilder_1.IndexBuilder; } });
+Object.defineProperty(exports, "createIndexBuilder", { enumerable: true, get: function () { return IndexBuilder_1.createIndexBuilder; } });
+var ProjectAssetService_1 = require("./ProjectAssetService");
+Object.defineProperty(exports, "ProjectAssetService", { enumerable: true, get: function () { return ProjectAssetService_1.ProjectAssetService; } });
+Object.defineProperty(exports, "createProjectAssetService", { enumerable: true, get: function () { return ProjectAssetService_1.createProjectAssetService; } });
+var ProjectScaffoldService_1 = require("./ProjectScaffoldService");
+Object.defineProperty(exports, "ProjectScaffoldService", { enumerable: true, get: function () { return ProjectScaffoldService_1.ProjectScaffoldService; } });
+Object.defineProperty(exports, "createProjectScaffoldService", { enumerable: true, get: function () { return ProjectScaffoldService_1.createProjectScaffoldService; } });
+var ProjectScaffoldCommandService_1 = require("./ProjectScaffoldCommandService");
+Object.defineProperty(exports, "ProjectScaffoldCommandService", { enumerable: true, get: function () { return ProjectScaffoldCommandService_1.ProjectScaffoldCommandService; } });
+Object.defineProperty(exports, "createProjectScaffoldCommandService", { enumerable: true, get: function () { return ProjectScaffoldCommandService_1.createProjectScaffoldCommandService; } });
+var ProjectService_1 = require("./ProjectService");
+Object.defineProperty(exports, "ProjectService", { enumerable: true, get: function () { return ProjectService_1.ProjectService; } });
+Object.defineProperty(exports, "createProjectService", { enumerable: true, get: function () { return ProjectService_1.createProjectService; } });
+var QueueService_1 = require("./QueueService");
+Object.defineProperty(exports, "QueueService", { enumerable: true, get: function () { return QueueService_1.QueueService; } });
+Object.defineProperty(exports, "createQueueService", { enumerable: true, get: function () { return QueueService_1.createQueueService; } });
+var RunService_1 = require("./RunService");
+Object.defineProperty(exports, "RunService", { enumerable: true, get: function () { return RunService_1.RunService; } });
+Object.defineProperty(exports, "createRunService", { enumerable: true, get: function () { return RunService_1.createRunService; } });
+// 服务容器
+const FileService_2 = require("./FileService");
+const ConfigManager_2 = require("./ConfigManager");
+const StateManager_2 = require("./StateManager");
+const SkillParser_2 = require("./SkillParser");
+const TemplateEngine_2 = require("./TemplateEngine");
+const ValidationService_2 = require("./ValidationService");
+const Logger_2 = require("./Logger");
+const IndexBuilder_2 = require("./IndexBuilder");
+const ProjectAssetService_2 = require("./ProjectAssetService");
+const ProjectScaffoldService_2 = require("./ProjectScaffoldService");
+const ProjectScaffoldCommandService_2 = require("./ProjectScaffoldCommandService");
+const ProjectService_2 = require("./ProjectService");
+const QueueService_2 = require("./QueueService");
+const RunService_2 = require("./RunService");
+class ServiceContainer {
+    constructor() {
+        this.fileService = FileService_2.fileService;
+        this.configManager = (0, ConfigManager_2.createConfigManager)(FileService_2.fileService);
+        this.stateManager = (0, StateManager_2.createStateManager)(FileService_2.fileService);
+        this.skillParser = SkillParser_2.skillParser;
+        this.templateEngine = TemplateEngine_2.templateEngine;
+        this.validationService = ValidationService_2.validationService;
+        this.logger = Logger_2.logger;
+        this.indexBuilder = (0, IndexBuilder_2.createIndexBuilder)(SkillParser_2.skillParser);
+        this.projectAssetService = (0, ProjectAssetService_2.createProjectAssetService)(FileService_2.fileService);
+        this.projectScaffoldService = (0, ProjectScaffoldService_2.createProjectScaffoldService)(FileService_2.fileService);
+        this.projectScaffoldCommandService = (0, ProjectScaffoldCommandService_2.createProjectScaffoldCommandService)(FileService_2.fileService, Logger_2.logger);
+        this.projectService = (0, ProjectService_2.createProjectService)(FileService_2.fileService, this.configManager, TemplateEngine_2.templateEngine, this.indexBuilder, this.skillParser, this.projectAssetService, this.projectScaffoldService, this.projectScaffoldCommandService);
+        this.queueService = (0, QueueService_2.createQueueService)(FileService_2.fileService, this.projectService);
+        this.runService = (0, RunService_2.createRunService)(FileService_2.fileService, this.projectService, this.queueService);
+    }
+    static getInstance() {
+        if (!ServiceContainer.instance) {
+            ServiceContainer.instance = new ServiceContainer();
+        }
+        return ServiceContainer.instance;
+    }
+}
+exports.ServiceContainer = ServiceContainer;
+exports.services = ServiceContainer.getInstance();
+//# sourceMappingURL=index.js.map

package/dist/services/templates/ExecutionTemplateBuilder.d.ts

@@ -0,0 +1,12 @@
+import { TemplateBuilderBase } from './TemplateBuilderBase';
+import { TemplateInputFactory } from './TemplateInputFactory';
+import { FeatureTemplateInput } from './templateTypes';
+export declare class ExecutionTemplateBuilder extends TemplateBuilderBase {
+    private readonly inputs;
+    constructor(inputs: TemplateInputFactory);
+    generateProposalTemplate(input: string | FeatureTemplateInput): string;
+    generateTasksTemplate(input: string | FeatureTemplateInput): string;
+    generateVerificationTemplate(input: string | FeatureTemplateInput): string;
+    generateReviewTemplate(input: string | FeatureTemplateInput): string;
+}
+//# sourceMappingURL=ExecutionTemplateBuilder.d.ts.map