@zhuan-ai/zhuanspec 2.8.0 → 2.9.5

package/dist/core/archive.js

@@ -531,7 +531,9 @@ export class ArchiveCommand {
             await this.copyDirectoryContentsIfExists(path.join(templateRoot, 'specs'), path.join(zhuanspecDir, 'specs'));
             console.log(chalk.gray('  → 同步 changes 目录...'));
             await this.copyDirectoryContentsIfExists(path.join(templateRoot, 'changes'), path.join(zhuanspecDir, 'changes'));
-            console.log(chalk.green(`✅ 已拉取 ${businessDirection} 业务模板（specs/changes）。`));
+            console.log(chalk.gray('  → 同步 knowledge 目录...'));
+            await this.copyDirectoryContentsIfExists(path.join(templateRoot, 'knowledge'), path.join(zhuanspecDir, 'knowledge'));
+            console.log(chalk.green(`✅ 已拉取 ${businessDirection} 业务模板（specs/changes/knowledge）。`));
         }
         finally {
             rmSync(tempRepo, { recursive: true, force: true });

package/dist/core/hooks/record-progress.js

@@ -211,38 +211,80 @@ function extractMcpTool(toolName) {
     return parts.length >= 3 ? parts[2] : undefined;
 }
 /**
- * Detect active change from progress.json files
- * Scans changes directory metrics progress.json to find non-idle phase
- * Returns null if no active change found
+ * Detect active change from progress.json files.
+ *
+ * Strategy:
+ * 1. Primary — if filePath is under zhuanspec/changes/{changeId}/, extract changeId directly.
+ * 2. Fallback — scan all changes and return the most recently updated one
+ *    (by lastUpdatedAt field; stub files without it fall back to filesystem mtime).
  */
-async function detectActiveChange(cwd) {
+async function detectActiveChange(cwd, filePath) {
     const changesDir = path.join(cwd, 'zhuanspec', 'changes');
     if (!await FileSystemUtils.directoryExists(changesDir)) {
         return null;
     }
+    // Primary: derive changeId from the file being modified
+    if (filePath) {
+        const absFilePath = path.isAbsolute(filePath) ? filePath : path.resolve(cwd, filePath);
+        const changesDirAbs = path.resolve(changesDir);
+        if (absFilePath.startsWith(changesDirAbs + path.sep)) {
+            const changeId = path.relative(changesDirAbs, absFilePath).split(path.sep)[0];
+            if (changeId && changeId !== 'archive') {
+                const progressPath = path.join(changesDirAbs, changeId, 'metrics', 'progress.json');
+                if (await FileSystemUtils.fileExists(progressPath)) {
+                    try {
+                        const progress = JSON.parse(await FileSystemUtils.readFile(progressPath));
+                        if (progress.phase && progress.phase !== 'idle' && PHASE_ORDER.includes(progress.phase)) {
+                            return { changeId, phase: progress.phase };
+                        }
+                    }
+                    catch {
+                        // Fall through to fallback
+                    }
+                }
+            }
+        }
+    }
+    // Fallback: most recently updated active change
     const entries = await fs.readdir(changesDir, { withFileTypes: true });
+    const candidates = [];
     for (const entry of entries) {
         if (!entry.isDirectory() || entry.name.startsWith('.') || entry.name === 'archive')
             continue;
         const progressPath = path.join(changesDir, entry.name, 'metrics', 'progress.json');
-        if (await FileSystemUtils.fileExists(progressPath)) {
-            try {
-                const progress = JSON.parse(await FileSystemUtils.readFile(progressPath));
-                if (progress.phase && progress.phase !== 'idle' && PHASE_ORDER.includes(progress.phase)) {
-                    return { changeId: entry.name, phase: progress.phase };
-                }
+        if (!await FileSystemUtils.fileExists(progressPath))
+            continue;
+        try {
+            const progress = JSON.parse(await FileSystemUtils.readFile(progressPath));
+            if (!progress.phase || progress.phase === 'idle' || !PHASE_ORDER.includes(progress.phase))
+                continue;
+            let sortKey;
+            if (progress.lastUpdatedAt) {
+                // "2026-04-22 11:39:59" (Beijing time) — replace space with T for Date parsing
+                sortKey = new Date(progress.lastUpdatedAt.replace(' ', 'T')).getTime();
+                if (isNaN(sortKey))
+                    sortKey = 0;
             }
-            catch {
-                // Ignore parse errors
+            else {
+                // Stub files (e.g. techDesign) lack lastUpdatedAt — use filesystem mtime
+                const stat = await fs.stat(progressPath);
+                sortKey = stat.mtime.getTime();
             }
+            candidates.push({ changeId: entry.name, phase: progress.phase, sortKey });
+        }
+        catch {
+            // Ignore parse errors
         }
     }
-    return null;
+    if (candidates.length === 0)
+        return null;
+    candidates.sort((a, b) => b.sortKey - a.sortKey);
+    return { changeId: candidates[0].changeId, phase: candidates[0].phase };
 }
 async function runRecordProgress(filePath, toolName, success, stdinData) {
     const cwd = process.cwd();
-    // Priority: progress.json > environment variables
-    const activeChange = await detectActiveChange(cwd);
+    // Priority: filePath-derived > progress.json scan > environment variables
+    const activeChange = await detectActiveChange(cwd, filePath);
     const phase = activeChange?.phase || process.env.ZHUANSPEC_PHASE || 'idle';
     const changeId = activeChange?.changeId || process.env.ZHUANSPEC_CHANGE_ID || '';
     const currentTask = process.env.ZHUANSPEC_CURRENT_TASK || '';
@@ -641,7 +683,7 @@ export async function initializeProgress(changeId, initialPhase = 'propose') {
  */
 export async function recordHookTrigger(hookName, hookPhase, success, options) {
     const cwd = process.cwd();
-    const activeChange = await detectActiveChange(cwd);
+    const activeChange = await detectActiveChange(cwd, options?.filePath);
     const phase = activeChange?.phase || process.env.ZHUANSPEC_PHASE || 'idle';
     const changeId = activeChange?.changeId || process.env.ZHUANSPEC_CHANGE_ID || '';
     if (!changeId || phase === 'idle')

package/dist/core/init.js

@@ -314,7 +314,7 @@ export class InitCommand {
             }
             const specTemplateSpinner = this.startSpinner(`正在同步 ${this.businessDirection} 业务规范模板...`);
             const syncResult = this.syncBusinessSpecTemplate(zhuanspecPath);
-            if (syncResult.syncedSpecs || syncResult.syncedChanges) {
+            if (syncResult.syncedSpecs || syncResult.syncedChanges || syncResult.syncedKnowledge) {
                 const syncedParts = [];
                 if (syncResult.syncedSpecs) {
                     syncedParts.push('specs');
@@ -322,6 +322,9 @@ export class InitCommand {
                 if (syncResult.syncedChanges) {
                     syncedParts.push('changes');
                 }
+                if (syncResult.syncedKnowledge) {
+                    syncedParts.push('knowledge');
+                }
                 specTemplateSpinner.stopAndPersist({
                     symbol: PALETTE.white('▌'),
                     text: PALETTE.white(`已从远端模板同步 ${syncedParts.join('、')} 目录`),
@@ -791,28 +794,29 @@ export class InitCommand {
     }
     syncBusinessSpecTemplate(zhuanspecPath) {
         if (!this.businessDirection) {
-            return { syncedSpecs: false, syncedChanges: false };
+            return { syncedSpecs: false, syncedChanges: false, syncedKnowledge: false };
         }
         const tempDir = this.cloneRemoteArchitectureRepoToTemp();
         if (!tempDir) {
-            return { syncedSpecs: false, syncedChanges: false };
+            return { syncedSpecs: false, syncedChanges: false, syncedKnowledge: false };
         }
         try {
             const specsRoot = path.join(tempDir, 'specs');
             const businessRoot = this.resolveBusinessDirectionRoot(specsRoot);
             if (!businessRoot) {
-                return { syncedSpecs: false, syncedChanges: false };
+                return { syncedSpecs: false, syncedChanges: false, syncedKnowledge: false };
             }
             const templateRoot = this.findFirstTemplateSourceRoot(businessRoot);
             if (!templateRoot) {
-                return { syncedSpecs: false, syncedChanges: false };
+                return { syncedSpecs: false, syncedChanges: false, syncedKnowledge: false };
             }
             const syncedSpecs = this.copyDirectoryContentsIfExists(path.join(templateRoot, 'specs'), path.join(zhuanspecPath, 'specs'));
             const syncedChanges = this.copyDirectoryContentsIfExists(path.join(templateRoot, 'changes'), path.join(zhuanspecPath, 'changes'));
-            return { syncedSpecs, syncedChanges };
+            const syncedKnowledge = this.copyDirectoryContentsIfExists(path.join(templateRoot, 'knowledge'), path.join(zhuanspecPath, 'knowledge'));
+            return { syncedSpecs, syncedChanges, syncedKnowledge };
         }
         catch {
-            return { syncedSpecs: false, syncedChanges: false };
+            return { syncedSpecs: false, syncedChanges: false, syncedKnowledge: false };
         }
         finally {
             rmSync(tempDir, { recursive: true, force: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhuan-ai/zhuanspec",
-  "version": "2.8.0",
+  "version": "2.9.5",
   "description": "AI-native system for spec-driven development",
   "keywords": [
     "zhuanspec",