@superkou/openspec 1.4.1 → 1.4.3

package/dist/core/command-generation/adapters/index.d.ts

@@ -28,5 +28,7 @@ export { qoderAdapter } from './qoder.js';
 export { lingmaAdapter } from './lingma.js';
 export { qwenAdapter } from './qwen.js';
 export { roocodeAdapter } from './roocode.js';
+export { traeAdapter } from './trae.js';
 export { windsurfAdapter } from './windsurf.js';
+export { zcodeAdapter } from './zcode.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/command-generation/adapters/index.js

@@ -28,5 +28,7 @@ export { qoderAdapter } from './qoder.js';
 export { lingmaAdapter } from './lingma.js';
 export { qwenAdapter } from './qwen.js';
 export { roocodeAdapter } from './roocode.js';
+export { traeAdapter } from './trae.js';
 export { windsurfAdapter } from './windsurf.js';
+export { zcodeAdapter } from './zcode.js';
 //# sourceMappingURL=index.js.map

package/dist/core/command-generation/adapters/trae.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Trae Command Adapter
+ *
+ * Formats commands for Trae following its command specification.
+ * Docs: Trae IDE 官方文档 - 命令功能
+ *
+ * Trae 支持项目级命令（.trae/commands/）和全局命令（~/.trae/commands/），
+ * 支持最多 3 层目录嵌套。本 adapter 生成项目级命令，路径为
+ * .trae/commands/opsx/<id>.md（2 层嵌套，在 3 层限制内）。
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * Trae adapter for command generation.
+ * File path: .trae/commands/opsx/<id>.md
+ * Frontmatter: name, description
+ */
+export declare const traeAdapter: ToolCommandAdapter;
+//# sourceMappingURL=trae.d.ts.map

package/dist/core/command-generation/adapters/trae.js

@@ -0,0 +1,32 @@
+/**
+ * Trae Command Adapter
+ *
+ * Formats commands for Trae following its command specification.
+ * Docs: Trae IDE 官方文档 - 命令功能
+ *
+ * Trae 支持项目级命令（.trae/commands/）和全局命令（~/.trae/commands/），
+ * 支持最多 3 层目录嵌套。本 adapter 生成项目级命令，路径为
+ * .trae/commands/opsx/<id>.md（2 层嵌套，在 3 层限制内）。
+ */
+import path from 'path';
+/**
+ * Trae adapter for command generation.
+ * File path: .trae/commands/opsx/<id>.md
+ * Frontmatter: name, description
+ */
+export const traeAdapter = {
+    toolId: 'trae',
+    getFilePath(commandId) {
+        return path.join('.trae', 'commands', 'opsx', `${commandId}.md`);
+    },
+    formatFile(content) {
+        return `---
+name: ${content.name}
+description: "${content.description}"
+---
+
+${content.body}
+`;
+    },
+};
+//# sourceMappingURL=trae.js.map

package/dist/core/command-generation/adapters/zcode.d.ts

@@ -0,0 +1,15 @@
+/**
+ * ZCode Command Adapter
+ *
+ * Formats commands for ZCode CLI following its command specification.
+ * ZCode 在 .zcode/commands/ 下使用扁平的 opsx-<id>.md 命令文件，
+ * frontmatter 含 description 与可选的 argument-hint。
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * ZCode adapter for command generation.
+ * File path: .zcode/commands/opsx-<id>.md
+ * Frontmatter: description, argument-hint
+ */
+export declare const zcodeAdapter: ToolCommandAdapter;
+//# sourceMappingURL=zcode.d.ts.map

package/dist/core/command-generation/adapters/zcode.js

@@ -0,0 +1,29 @@
+/**
+ * ZCode Command Adapter
+ *
+ * Formats commands for ZCode CLI following its command specification.
+ * ZCode 在 .zcode/commands/ 下使用扁平的 opsx-<id>.md 命令文件，
+ * frontmatter 含 description 与可选的 argument-hint。
+ */
+import path from 'path';
+/**
+ * ZCode adapter for command generation.
+ * File path: .zcode/commands/opsx-<id>.md
+ * Frontmatter: description, argument-hint
+ */
+export const zcodeAdapter = {
+    toolId: 'zcode',
+    getFilePath(commandId) {
+        return path.join('.zcode', 'commands', `opsx-${commandId}.md`);
+    },
+    formatFile(content) {
+        return `---
+description: ${content.description}
+argument-hint: command arguments
+---
+
+${content.body}
+`;
+    },
+};
+//# sourceMappingURL=zcode.js.map

package/dist/core/command-generation/registry.js

@@ -29,7 +29,9 @@ import { qoderAdapter } from './adapters/qoder.js';
 import { lingmaAdapter } from './adapters/lingma.js';
 import { qwenAdapter } from './adapters/qwen.js';
 import { roocodeAdapter } from './adapters/roocode.js';
+import { traeAdapter } from './adapters/trae.js';
 import { windsurfAdapter } from './adapters/windsurf.js';
+import { zcodeAdapter } from './adapters/zcode.js';
 /**
  * Registry for looking up tool command adapters.
  */
@@ -62,7 +64,9 @@ export class CommandAdapterRegistry {
         CommandAdapterRegistry.register(lingmaAdapter);
         CommandAdapterRegistry.register(qwenAdapter);
         CommandAdapterRegistry.register(roocodeAdapter);
+        CommandAdapterRegistry.register(traeAdapter);
         CommandAdapterRegistry.register(windsurfAdapter);
+        CommandAdapterRegistry.register(zcodeAdapter);
     }
     /**
      * Register a tool command adapter.

package/dist/core/config.js

@@ -32,8 +32,9 @@ export const AI_TOOLS = [
     { name: 'Qoder', value: 'qoder', available: true, successLabel: 'Qoder', skillsDir: '.qoder' },
     { name: 'Qwen Code', value: 'qwen', available: true, successLabel: 'Qwen Code', skillsDir: '.qwen' },
     { name: 'RooCode', value: 'roocode', available: true, successLabel: 'RooCode', skillsDir: '.roo' },
-    { name: 'Trae', value: 'trae', available: true, successLabel: 'Trae', skillsDir: '.trae' },
+    { name: 'Trae', value: 'trae', available: true, successLabel: 'Trae', skillsDir: '.trae', detectionPaths: ['.trae/commands', '.trae/skills'] },
     { name: 'Windsurf', value: 'windsurf', available: true, successLabel: 'Windsurf', skillsDir: '.windsurf' },
+    { name: 'ZCode', value: 'zcode', available: true, successLabel: 'ZCode', skillsDir: '.zcode', detectionPaths: ['.zcode/commands', '.zcode/skills'] },
     { name: 'AGENTS.md (works with Amp, VS Code, …)', value: 'agents', available: false, successLabel: 'your AGENTS.md-compatible assistant' }
 ];
 //# sourceMappingURL=config.js.map

package/dist/utils/change-utils.d.ts

@@ -31,18 +31,24 @@ export interface ValidationResult {
 /**
  * Validates that a change name follows kebab-case conventions.
  *
- * Valid names:
- * - Start with a lowercase letter
+ * Valid names (two accepted forms):
+ * - Classic kebab-case: starts with a lowercase letter
+ *   (e.g., `add-auth`, `refactor-db`)
+ * - MMDD-prefixed kebab-case: starts with a 4-digit date (MMDD) followed by `-`
+ *   and a kebab-case suffix (e.g., `0628-add-auth`)
+ *
+ * Both forms:
  * - Contain only lowercase letters, numbers, and hyphens
- * - Do not start or end with a hyphen
+ * - Do not start or end with a hyphen (the MMDD prefix's hyphen is part of the prefix)
  * - Do not contain consecutive hyphens
  *
  * @param name - The change name to validate
  * @returns Validation result with `valid: true` or `valid: false` with an error message
  *
  * @example
- * validateChangeName('add-auth') // { valid: true }
- * validateChangeName('Add-Auth') // { valid: false, error: '...' }
+ * validateChangeName('add-auth')        // { valid: true }
+ * validateChangeName('0628-add-auth')   // { valid: true }
+ * validateChangeName('Add-Auth')        // { valid: false, error: '...' }
  */
 export declare function validateChangeName(name: string): ValidationResult;
 /**

package/dist/utils/change-utils.js

@@ -6,23 +6,30 @@ const DEFAULT_SCHEMA = 'spec-driven';
 /**
  * Validates that a change name follows kebab-case conventions.
  *
- * Valid names:
- * - Start with a lowercase letter
+ * Valid names (two accepted forms):
+ * - Classic kebab-case: starts with a lowercase letter
+ *   (e.g., `add-auth`, `refactor-db`)
+ * - MMDD-prefixed kebab-case: starts with a 4-digit date (MMDD) followed by `-`
+ *   and a kebab-case suffix (e.g., `0628-add-auth`)
+ *
+ * Both forms:
  * - Contain only lowercase letters, numbers, and hyphens
- * - Do not start or end with a hyphen
+ * - Do not start or end with a hyphen (the MMDD prefix's hyphen is part of the prefix)
  * - Do not contain consecutive hyphens
  *
  * @param name - The change name to validate
  * @returns Validation result with `valid: true` or `valid: false` with an error message
  *
  * @example
- * validateChangeName('add-auth') // { valid: true }
- * validateChangeName('Add-Auth') // { valid: false, error: '...' }
+ * validateChangeName('add-auth')        // { valid: true }
+ * validateChangeName('0628-add-auth')   // { valid: true }
+ * validateChangeName('Add-Auth')        // { valid: false, error: '...' }
  */
 export function validateChangeName(name) {
-    // Pattern: starts with lowercase letter, followed by lowercase letters/numbers,
-    // optionally followed by hyphen + lowercase letters/numbers (repeatable)
-    const kebabCasePattern = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;
+    // Pattern: two accepted forms.
+    //   Form 1 (classic): ^[a-z][a-z0-9]*(-[a-z0-9]+)*$
+    //   Form 2 (MMDD-prefixed): ^\d{4}-[a-z][a-z0-9]*(-[a-z0-9]+)*$
+    const kebabCasePattern = /^(?:[a-z][a-z0-9]*(?:-[a-z0-9]+)*|\d{4}-[a-z][a-z0-9]*(?:-[a-z0-9]+)*)$/;
     if (!name) {
         return { valid: false, error: 'Change name cannot be empty' };
     }
@@ -49,10 +56,14 @@ export function validateChangeName(name) {
         if (/[^a-z0-9-]/.test(name)) {
             return { valid: false, error: 'Change name can only contain lowercase letters, numbers, and hyphens' };
         }
-        if (/^[0-9]/.test(name)) {
-            return { valid: false, error: 'Change name must start with a letter' };
+        // Numeric-prefixed name that didn't match Form 2: diagnose the date prefix shape
+        if (/^\d/.test(name)) {
+            if (!/^\d{4}-[a-z]/.test(name)) {
+                return { valid: false, error: 'Numeric-prefixed change name must use MMDD-<kebab> form (e.g., 0628-add-auth)' };
+            }
+            return { valid: false, error: 'Change name with MMDD prefix must be followed by kebab-case (e.g., 0628-add-auth)' };
         }
-        return { valid: false, error: 'Change name must follow kebab-case convention (e.g., add-auth, refactor-db)' };
+        return { valid: false, error: 'Change name must follow kebab-case convention (e.g., add-auth, 0628-add-auth)' };
     }
     return { valid: true };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superkou/openspec",
-  "version": "1.4.1",
+  "version": "1.4.3",
   "description": "AI-native system for spec-driven development",
   "keywords": [
     "openspec",
@@ -9,10 +9,10 @@
     "ai",
     "development"
   ],
-  "homepage": "https://github.com/Fission-AI/OpenSpec",
+  "homepage": "https://github.com/sevensky/OpenSpec",
   "repository": {
     "type": "git",
-    "url": "https://github.com/Fission-AI/OpenSpec"
+    "url": "git+https://github.com/sevensky/OpenSpec.git"
   },
   "license": "MIT",
   "author": "OpenSpec Contributors",
@@ -28,7 +28,7 @@
     }
   },
   "bin": {
-    "openspec": "./bin/openspec.js"
+    "openspec": "bin/openspec.js"
   },
   "files": [
     "dist",

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

@@ -1,3 +1,8 @@
+<!-- 
+命名约定：change 目录名用 MMDD-<kebab> 前缀（如 0628-add-auth），便于按日期排序与追溯。
+校验已支持两种形式：经典 kebab（add-auth）与 MMDD- 前缀（0628-add-auth），优先用后者。 
+-->
+
 ## Why
 
 <!-- 说明此变更的动机。解决什么问题？为什么现在做？ -->
@@ -9,13 +14,17 @@
 ## Capabilities
 
 ### New Capabilities
-<!-- 引入的新能力。将 <name> 替换为 kebab-case 标识符（例如 user-auth、data-export、api-rate-limiting）。每个将创建 specs/<name>/spec.md -->
+<!-- 
+引入的新能力。将 <name> 替换为 kebab-case 标识符（例如 user-auth、data-export、api-rate-limiting）。每个将创建 specs/<name>/spec.md 
+-->
 - `<name>`: <此能力覆盖范围的简要描述>
 
 ### Modified Capabilities
-<!-- 需求发生变化的既有能力（不涉及实现细节）。
-     仅当 spec 级别行为变化时列出。每个需要 delta spec 文件。
-     使用 openspec/specs/ 中的既有 spec 名称。如无需求变更则留空。 -->
+<!-- 
+需求发生变化的既有能力（不涉及实现细节）。
+仅当 spec 级别行为变化时列出。每个需要 delta spec 文件。
+使用 openspec/specs/ 中的既有 spec 名称。如无需求变更则留空。 
+-->
 - `<existing-name>`: <哪些需求正在变化>
 
 ## Impact