@superkou/openspec 1.4.2 → 1.4.3

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.2",
+  "version": "1.4.3",
   "description": "AI-native system for spec-driven development",
   "keywords": [
     "openspec",
@@ -39,6 +39,24 @@
     "!dist/**/__tests__",
     "!dist/**/*.map"
   ],
+  "scripts": {
+    "lint": "eslint src/",
+    "build": "node build.js",
+    "dev": "tsc --watch",
+    "dev:cli": "pnpm build && node bin/openspec.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:ui": "vitest --ui",
+    "test:coverage": "vitest --coverage",
+    "test:postinstall": "node scripts/postinstall.js",
+    "prepare": "pnpm run build",
+    "prepublishOnly": "pnpm run build",
+    "postinstall": "node scripts/postinstall.js",
+    "check:pack-version": "node scripts/pack-version-check.mjs",
+    "release": "pnpm run release:ci",
+    "release:ci": "pnpm run check:pack-version && pnpm exec changeset publish",
+    "changeset": "changeset"
+  },
   "engines": {
     "node": ">=20.19.0"
   },
@@ -63,21 +81,5 @@
     "posthog-node": "^5.20.0",
     "yaml": "^2.8.2",
     "zod": "^4.0.17"
-  },
-  "scripts": {
-    "lint": "eslint src/",
-    "build": "node build.js",
-    "dev": "tsc --watch",
-    "dev:cli": "pnpm build && node bin/openspec.js",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:ui": "vitest --ui",
-    "test:coverage": "vitest --coverage",
-    "test:postinstall": "node scripts/postinstall.js",
-    "postinstall": "node scripts/postinstall.js",
-    "check:pack-version": "node scripts/pack-version-check.mjs",
-    "release": "pnpm run release:ci",
-    "release:ci": "pnpm run check:pack-version && pnpm exec changeset publish",
-    "changeset": "changeset"
   }
-}
+}

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