@zhuan-ai/zhuanspec 2.11.6 → 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/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)) {
@@ -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/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