@zhuan-ai/zhuanspec 2.11.4 → 2.11.10

package/dist/cli/hooks.js

@@ -23,6 +23,7 @@ import { postApplyHook, executePostApply } from '../core/hooks/post-apply.js';
 import { codeReviewResultCheck, unitTestResultCheck, specConsistencyResultCheck, generateReviewReport, } from '../core/hooks/review-hooks.js';
 import path from 'path';
 import { FileSystemUtils } from '../utils/file-system.js';
+import { resolveZhuanSpecRoot } from '../utils/resolve-root.js';
 const program = new Command();
 program
     .name('zhuanspec-hook')
@@ -295,7 +296,7 @@ program
  * Phase Transition Check - Unified function for phase transition validation
  */
 async function runPhaseTransitionCheck(options) {
-    const cwd = process.cwd();
+    const cwd = resolveZhuanSpecRoot();
     const changeId = options.change || process.env.ZHUANSPEC_CHANGE_ID || '';
     const fromPhase = options.from || process.env.ZHUANSPEC_PHASE || 'idle';
     const toPhase = options.to || '';
@@ -394,7 +395,7 @@ async function runPhaseTransitionCheck(options) {
     }
 }
 async function collectHookStatus() {
-    const cwd = process.cwd();
+    const cwd = resolveZhuanSpecRoot();
     const settingsPath = path.join(cwd, '.claude', 'settings.json');
     const settingsExists = await FileSystemUtils.fileExists(settingsPath);
     const registeredLifecycleHooks = [];

package/dist/commands/change.js

@@ -1,5 +1,6 @@
 import { promises as fs } from 'fs';
 import path from 'path';
+import chalk from 'chalk';
 import { JsonConverter } from '../core/converters/json-converter.js';
 import { Validator } from '../core/validation/validator.js';
 import { ChangeParser } from '../core/parsers/change-parser.js';
@@ -211,11 +212,15 @@ export class ChangeCommand {
                 console.log(`Change "${changeName}" is valid`);
             }
             else {
-                console.error(`Change "${changeName}" has issues`);
+                console.error(`变更 "${changeName}" 存在问题`);
                 report.issues.forEach(issue => {
-                    const label = issue.level === 'ERROR' ? 'ERROR' : 'WARNING';
-                    const prefix = issue.level === 'ERROR' ? '✗' : '⚠';
-                    console.error(`${prefix} [${label}] ${issue.path}: ${issue.message}`);
+                    const label = issue.level === 'ERROR' ? '错误' : '警告';
+                    if (issue.level === 'ERROR') {
+                        console.error(chalk.red(`✗ [${label}] ${issue.path}: ${issue.message}`));
+                    }
+                    else {
+                        console.error(chalk.yellow(`⚠ [${label}] ${issue.path}: ${issue.message}`));
+                    }
                 });
                 // Next steps footer to guide fixing issues
                 this.printNextSteps();

package/dist/commands/progress.js

@@ -11,6 +11,7 @@ import { promises as fs } from 'fs';
 import { FileSystemUtils } from '../utils/file-system.js';
 import { PHASE_ORDER } from '../utils/phase-utils.js';
 import { initializeProgress } from '../core/hooks/record-progress.js';
+import { resolveZhuanSpecRoot } from '../utils/resolve-root.js';
 export class ProgressCommand {
     /**
      * Recover damaged progress.json using three-tier fallback strategy
@@ -80,7 +81,7 @@ export class ProgressCommand {
      * Usage: zhuanspec progress show <change-id>
      */
     async show(changeId, options) {
-        const cwd = process.cwd();
+        const cwd = resolveZhuanSpecRoot();
         const zhuanspecDir = path.join(cwd, 'zhuanspec');
         const changeDir = path.join(zhuanspecDir, 'changes', changeId);
         const metricsDir = path.join(changeDir, 'metrics');
@@ -110,7 +111,7 @@ export class ProgressCommand {
         }
     }
     async execute(options) {
-        const cwd = process.cwd();
+        const cwd = resolveZhuanSpecRoot();
         const zhuanspecDir = path.join(cwd, 'zhuanspec');
         // Check if zhuanspec directory exists
         if (!await FileSystemUtils.fileExists(zhuanspecDir)) {
@@ -211,12 +212,12 @@ export class ProgressCommand {
                 });
                 continue;
             }
-            // Match "Task X.Y" format: #### Task 1.0: description or #### Task 1.1: description
-            const taskXYMatch = line.match(/^####\s*Task\s+(\d+\.\d+)\s*:\s*(.+)$/i);
+            // Match "Task X.Y" or bare "X.Y" format: #### Task 1.0: description or #### 1.1 description
+            const taskXYMatch = line.match(/^####\s*(?:Task\s+)?(\d+\.\d+)[\s:]\s*(.+)$/i);
             if (taskXYMatch) {
                 const taskId = taskXYMatch[1];
                 const rawDescription = taskXYMatch[2].trim();
-                const isCompleted = rawDescription.endsWith('✅');
+                const isCompleted = rawDescription.endsWith('\u2705');
                 const description = isCompleted
                     ? rawDescription.slice(0, -1).trim()
                     : rawDescription;
@@ -351,7 +352,7 @@ export class ProgressCommand {
      * Usage: zhuanspec progress set-phase <change-id> <phase>
      */
     async setPhase(changeId, phase) {
-        const cwd = process.cwd();
+        const cwd = resolveZhuanSpecRoot();
         const changeDir = path.join(cwd, 'zhuanspec', 'changes', changeId);
         if (!await FileSystemUtils.directoryExists(changeDir)) {
             throw new Error(`Change '${changeId}' not found`);

package/dist/commands/spec.js

@@ -1,3 +1,4 @@
+import chalk from 'chalk';
 import { existsSync, readdirSync, readFileSync } from 'fs';
 import { join } from 'path';
 import { MarkdownParser } from '../core/parsers/markdown-parser.js';
@@ -205,11 +206,18 @@ export function registerSpecCommand(rootProgram) {
                     console.log(`Specification '${specId}' is valid`);
                 }
                 else {
-                    console.error(`Specification '${specId}' has issues`);
+                    console.error(`规范 '${specId}' 存在问题`);
                     report.issues.forEach(issue => {
-                        const label = issue.level === 'ERROR' ? 'ERROR' : issue.level;
-                        const prefix = issue.level === 'ERROR' ? '✗' : issue.level === 'WARNING' ? '⚠' : 'ℹ';
-                        console.error(`${prefix} [${label}] ${issue.path}: ${issue.message}`);
+                        const label = issue.level === 'ERROR' ? '错误' : issue.level === 'WARNING' ? '警告' : '提示';
+                        if (issue.level === 'ERROR') {
+                            console.error(chalk.red(`✗ [${label}] ${issue.path}: ${issue.message}`));
+                        }
+                        else if (issue.level === 'WARNING') {
+                            console.error(chalk.yellow(`⚠ [${label}] ${issue.path}: ${issue.message}`));
+                        }
+                        else {
+                            console.error(`ℹ [${label}] ${issue.path}: ${issue.message}`);
+                        }
                     });
                 }
             }

package/dist/commands/validate.js

@@ -292,18 +292,25 @@ export class ValidateCommand {
             }
         }
         else {
-            console.error(`${type === 'change' ? 'Change' : 'Specification'} '${id}' has issues`);
+            console.error(`${type === 'change' ? '变更' : '规范'} '${id}' 存在问题`);
             for (const issue of report.issues) {
-                const label = issue.level === 'ERROR' ? 'ERROR' : issue.level;
-                const prefix = issue.level === 'ERROR' ? '✗' : issue.level === 'WARNING' ? '⚠' : 'ℹ';
-                console.error(`${prefix} [${label}] ${issue.path}: ${issue.message}`);
+                const label = issue.level === 'ERROR' ? '错误' : issue.level === 'WARNING' ? '警告' : '提示';
+                if (issue.level === 'ERROR') {
+                    console.error(chalk.red(`✗ [${label}] ${issue.path}: ${issue.message}`));
+                }
+                else if (issue.level === 'WARNING') {
+                    console.error(chalk.yellow(`⚠ [${label}] ${issue.path}: ${issue.message}`));
+                }
+                else {
+                    console.error(`ℹ [${label}] ${issue.path}: ${issue.message}`);
+                }
             }
             this.printNextSteps(type);
         }
         // Print strict mode checks summary if available
         if (opts?.strict && report.strictChecks && report.strictChecks.length > 0) {
             console.log('');
-            console.log('Strict Mode Checks:');
+            console.log('严格模式检查：');
             for (const check of report.strictChecks) {
                 if (check.passed) {
                     console.log(`  ${chalk.green('✓')} ${check.ruleName}`);
@@ -311,7 +318,9 @@ export class ValidateCommand {
                 else {
                     const firstError = check.errors[0] || check.warnings[0] || '';
                     const errorSuffix = firstError ? ` — ${firstError}` : '';
-                    console.log(`  ${chalk.red('✗')} ${check.ruleName}${errorSuffix}`);
+                    const hasErrors = check.errors.length > 0;
+                    const color = hasErrors ? chalk.red : chalk.yellow;
+                    console.log(`  ${color('✗')} ${check.ruleName}${errorSuffix}`);
                 }
             }
         }

package/dist/core/artifact-graph/instruction-loader.d.ts

@@ -100,7 +100,9 @@ export interface ChangeStatus {
  * @returns The template content
  * @throws TemplateLoadError if the template cannot be loaded
  */
-export declare function loadTemplate(schemaName: string, templatePath: string): string;
+export declare function loadTemplate(schemaName: string, templatePath: string, options?: {
+    changeName?: string;
+}): string;
 /**
  * Loads change context combining graph and completion state.
  *

package/dist/core/artifact-graph/instruction-loader.js

@@ -5,6 +5,8 @@ import { ArtifactGraph } from './graph.js';
 import { detectCompleted } from './state.js';
 import { resolveSchemaForChange } from '../../utils/change-metadata.js';
 import { loadProjectConfig, getEffectiveRules } from '../project-config.js';
+import { getTasksTemplate } from '../templates/tasks-template.js';
+import { getTddTasksTemplate } from '../templates/tdd-tasks-template.js';
 /**
  * Error thrown when loading a template fails.
  */
@@ -24,7 +26,13 @@ export class TemplateLoadError extends Error {
  * @returns The template content
  * @throws TemplateLoadError if the template cannot be loaded
  */
-export function loadTemplate(schemaName, templatePath) {
+export function loadTemplate(schemaName, templatePath, options) {
+    // Prefer TypeScript template functions as single source of truth
+    const tsTemplate = loadFromTypeScriptTemplate(schemaName, templatePath, options);
+    if (tsTemplate !== null) {
+        return tsTemplate;
+    }
+    // Fallback: load from static file
     const schemaDir = getSchemaDir(schemaName);
     if (!schemaDir) {
         throw new TemplateLoadError(`Schema '${schemaName}' not found`, templatePath);
@@ -41,6 +49,23 @@ export function loadTemplate(schemaName, templatePath) {
         throw new TemplateLoadError(`Failed to read template: ${ioError.message}`, fullPath);
     }
 }
+/**
+ * Attempt to load template from TypeScript template functions.
+ * Returns null if no TypeScript template is registered for this schema+template combination.
+ * This ensures TypeScript templates are the single source of truth,
+ * avoiding dual-track desync between .ts functions and static .md files.
+ */
+function loadFromTypeScriptTemplate(schemaName, templatePath, options) {
+    if (templatePath === 'tasks.md') {
+        if (schemaName === 'spec-driven') {
+            return getTasksTemplate({ changeId: options?.changeName || '[change-id]' });
+        }
+        if (schemaName === 'tdd') {
+            return getTddTasksTemplate({ changeId: options?.changeName || '[change-id]' });
+        }
+    }
+    return null;
+}
 /**
  * Loads change context combining graph and completion state.
  *
@@ -82,7 +107,7 @@ export function generateInstructions(context, artifactId) {
     if (!artifact) {
         throw new Error(`Artifact '${artifactId}' not found in schema '${context.schemaName}'`);
     }
-    const template = loadTemplate(context.schemaName, artifact.template);
+    const template = loadTemplate(context.schemaName, artifact.template, { changeName: context.changeName });
     const dependencies = getDependencyInfo(artifact, context.graph, context.completed);
     const unlocks = getUnlockedArtifacts(context.graph, artifactId);
     // Load project config for context/rules injection

package/dist/core/business-assets-sync.d.ts

@@ -0,0 +1,94 @@
+export declare const ARCH_REPO_URL = "http://gitlab.zhuanspirit.com/zz-kf/spec_repo.git";
+export declare const ARCH_REPO_BRANCH = "spec_repo-feature-6612-2";
+export type ClaudeAssetSource = 'business' | 'common' | 'none';
+export type FileSyncStatus = 'copied' | 'overwritten' | 'skipped-unchanged';
+export type ClaudeAssetFileSyncResult = {
+    source: ClaudeAssetSource;
+    files: {
+        added: string[];
+        overwritten: string[];
+        skipped: string[];
+    };
+};
+export type ClaudeAssetSyncResult = {
+    claudeMd: {
+        source: ClaudeAssetSource;
+        status: FileSyncStatus | 'missing';
+    };
+    dotClaude: ClaudeAssetFileSyncResult;
+};
+export type SpecTemplateSyncDetail = {
+    synced: boolean;
+    added: number;
+    skipped: number;
+};
+export type SpecTemplateSyncResult = {
+    syncedSpecs: boolean;
+    syncedChanges: boolean;
+    syncedKnowledge: boolean;
+    specs: SpecTemplateSyncDetail;
+    changes: SpecTemplateSyncDetail;
+    knowledge: SpecTemplateSyncDetail;
+};
+export declare function cloneArchRepoToTemp(prefix?: string): string | null;
+export declare function readBusinessDirection(zhuanspecPath: string): string | null;
+export declare function resolveBusinessDirectionRoot(specsRoot: string, businessDirection: string | null): string | null;
+export declare function findFirstDirectoryByName(searchRoot: string, targetName: string): string | null;
+export declare function findFirstTemplateSourceRoot(searchRoot: string): string | null;
+export declare function copyDirectoryContentsIfExists(sourceDir: string, targetDir: string): boolean;
+/**
+ * Recursively copy src to dst.
+ * If the target file already exists, it is left untouched (skipped).
+ * This protects user's local modifications, used by `zhuanspec update`.
+ */
+export declare function mergeDirectoryAdditive(sourceDir: string, targetDir: string): {
+    exists: boolean;
+    added: number;
+    skipped: number;
+};
+export declare function resolveClaudeAssetSource(businessPath: string | null, commonPath: string): {
+    source: Exclude<ClaudeAssetSource, 'none'>;
+    path: string;
+} | null;
+export declare function copyClaudeFileIfNeeded(sourceAsset: {
+    source: Exclude<ClaudeAssetSource, 'none'>;
+    path: string;
+} | null, targetPath: string): {
+    source: ClaudeAssetSource;
+    status: FileSyncStatus | 'missing';
+};
+export declare function copyClaudeDirectoryIfNeeded(sourceAsset: {
+    source: Exclude<ClaudeAssetSource, 'none'>;
+    path: string;
+} | null, targetPath: string): ClaudeAssetFileSyncResult;
+export declare function copyClaudeDirectoryFromCommon(commonSourcePath: string, targetPath: string): ClaudeAssetFileSyncResult;
+export declare function fetchRemoteArchitectureFiles(existingTempDir?: string | null): string[];
+export declare function fetchRemoteArchitectureContent(fileName: string, existingTempDir?: string | null): string | null;
+/**
+ * Fetch the business architecture file content.
+ *
+ * Priority:
+ *   1. remote clone (via `existingTempDir` if provided, otherwise fresh clone)
+ *   2. `git show` from local repo at `repoCwd` (skipped when repoCwd is null)
+ *   3. direct file read from `repoCwd` (skipped when repoCwd is null)
+ */
+export declare function fetchArchitectureFile(businessDirection: string | null, repoCwd: string | null, existingTempDir?: string | null): Promise<string | null>;
+/**
+ * Sync business-scoped template directories (specs / changes / knowledge).
+ * `mode='overwrite'` preserves legacy init behavior (cpSync force:true).
+ * `mode='additive'` only creates missing files (used by `zhuanspec update`).
+ */
+export declare function syncBusinessSpecTemplate(zhuanspecPath: string, businessDirection: string | null, mode?: 'overwrite' | 'additive', existingTempDir?: string | null): SpecTemplateSyncResult;
+export declare function syncBusinessClaudeAssets(projectPath: string, businessDirection: string | null, existingTempDir?: string | null): ClaudeAssetSyncResult;
+/**
+ * Sync `.claude/` from the common directory only.
+ * Used by `zhuanspec update` when no `.business-direction` is configured.
+ */
+export declare function syncCommonDotClaude(projectPath: string, existingTempDir?: string | null): {
+    attempted: boolean;
+    synced: boolean;
+    added: number;
+    overwritten: number;
+    skipped: number;
+};
+//# sourceMappingURL=business-assets-sync.d.ts.map