@zhuan-ai/zhuanspec 1.3.0 → 2.0.0-newApply

package/README.zh.md

@@ -415,7 +415,7 @@ npm install -g ./distributions/fission-ai-zhuanspec-1.0.0.tgz
 
 1. **升级包**
    ```bash
-   npm install -g @fission-ai/zhuanspec@latest
+   npm install -g @zhuan-ai/zhuanspec@latest
    ```
 2. **刷新代理说明**
    - 在每个项目内运行 `zhuanspec update` 以重新生成 AI 指导并确保最新的斜杠命令处于活动状态。

package/bin/zhuanspec-hook.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+import '../dist/cli/hooks.js';

package/dist/cli/hooks.d.ts

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+/**
+ * ZhuanSpec Hooks CLI Entry Point
+ *
+ * This CLI provides hook commands for Claude Code integration:
+ * - init: SessionStart hook - Initialize ZhuanSpec environment
+ * - deviation-check: PreToolUse hook - Check for proposal deviations
+ * - record-progress: PostToolUse hook - Record task progress
+ * - collect-knowledge: PostToolUse hook - Collect knowledge from interactions
+ * - summarize: Stop hook - Summarize session progress
+ * - review-*: Review phase hooks - Check skill outputs and control fix loops
+ */
+/**
+ * Phase Transition Check - Unified function for phase transition validation
+ */
+export declare function runPhaseTransitionCheck(options: {
+    from?: string;
+    to?: string;
+    change?: string;
+}): Promise<{
+    continue: boolean;
+    systemMessage?: string;
+    checks?: Record<string, boolean>;
+    requiresUserConfirmation?: boolean;
+}>;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/cli/hooks.js

@@ -0,0 +1,558 @@
+#!/usr/bin/env node
+/**
+ * ZhuanSpec Hooks CLI Entry Point
+ *
+ * This CLI provides hook commands for Claude Code integration:
+ * - init: SessionStart hook - Initialize ZhuanSpec environment
+ * - deviation-check: PreToolUse hook - Check for proposal deviations
+ * - record-progress: PostToolUse hook - Record task progress
+ * - collect-knowledge: PostToolUse hook - Collect knowledge from interactions
+ * - summarize: Stop hook - Summarize session progress
+ * - review-*: Review phase hooks - Check skill outputs and control fix loops
+ */
+import { Command } from 'commander';
+import { initHook } from '../core/hooks/init.js';
+import { deviationCheckHook } from '../core/hooks/deviation-check.js';
+import { recordProgressHook, initializeProgress } from '../core/hooks/record-progress.js';
+import { collectKnowledgeHook } from '../core/hooks/collect-knowledge.js';
+import { knowledgeUsageHook } from '../core/hooks/knowledge-usage.js';
+import { knowledgeReferencesHook } from '../core/hooks/knowledge-references.js';
+import { summarizeHook } from '../core/hooks/summarize.js';
+import { runUserInputHook } from '../core/hooks/user-input-hook.js';
+import { preArchiveHook } from '../core/hooks/pre-archive.js';
+import { postArchiveHook } from '../core/hooks/post-archive.js';
+import { preApplyHook, checkPreApplyConditions } from '../core/hooks/pre-apply.js';
+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')
+    .description('ZhuanSpec hooks for Claude Code integration')
+    .version('1.0.0');
+// SessionStart hook
+program
+    .command('init')
+    .description('SessionStart hook - Initialize ZhuanSpec environment')
+    .option('--json', 'Output as JSON for Claude Code consumption')
+    .action(async (options) => {
+    await initHook(options);
+});
+// PreToolUse hook
+program
+    .command('deviation-check')
+    .description('PreToolUse hook - Check for proposal deviations before Write/Edit')
+    .option('--json', 'Output as JSON for Claude Code consumption')
+    .option('--file <path>', 'File being modified')
+    .option('--tool <name>', 'Tool being used (Write/Edit)')
+    .option('--trigger <type>', 'Trigger type: pre-tool|post-prompt|resume')
+    .option('--prompt <text>', 'Prompt content for post-prompt checks')
+    .action(async (options) => {
+    // v2.15.16 Sprint 3：'post-prompt' 分支已由 user-input-hook 接管，此处保留参数仅为
+    // 兼容 v2.15.14 及更早版本的 .claude/settings.json（未执行过 zhuanspec update）。
+    // 收到 post-prompt 时直接 no-op 返回，避免破坏 UserPromptSubmit 事件链。
+    if (options.trigger === 'post-prompt') {
+        if (options.json) {
+            console.log(JSON.stringify({ continue: true, hookSpecificOutput: { hookEventName: 'UserPromptSubmit' } }));
+        }
+        return;
+    }
+    const { trigger, ...rest } = options;
+    await deviationCheckHook({ ...rest, trigger: trigger });
+});
+// PostToolUse hook - record progress
+program
+    .command('record-progress')
+    .description('PostToolUse hook - Record task progress after Write/Edit')
+    .option('--json', 'Output as JSON for Claude Code consumption')
+    .option('--file <path>', 'File that was modified')
+    .option('--tool <name>', 'Tool that was used (Write/Edit)')
+    .option('--success <boolean>', 'Whether the operation succeeded')
+    .action(async (options) => {
+    await recordProgressHook(options);
+});
+// Initialize progress - create progress.json at Propose phase start
+program
+    .command('init-progress')
+    .description('Initialize progress.json for a change at Propose phase start')
+    .option('--change <id>', 'Change ID')
+    .action(async (options) => {
+    if (!options.change) {
+        console.error('Error: --change <id> is required');
+        process.exit(1);
+    }
+    await initializeProgress(options.change);
+    console.log(`✓ Progress initialized for change: ${options.change}`);
+});
+// PostToolUse hook - collect knowledge
+program
+    .command('collect-knowledge')
+    .description('PostToolUse hook - Collect knowledge from interactions')
+    .option('--json', 'Output as JSON for Claude Code consumption')
+    .option('--file <path>', 'File that was modified')
+    .option('--content <string>', 'Content that was written')
+    .action(async (options) => {
+    await collectKnowledgeHook(options);
+});
+// PostToolUse hook - knowledge usage（引用上报，旁路指标）
+program
+    .command('knowledge-usage')
+    .description('PostToolUse hook - 记录 AI 引用 knowledge/ 知识文件的次数（旁路指标）')
+    .option('--json', 'Output as JSON for Claude Code consumption')
+    .option('--file <path>', 'File that was read (override stdin tool_input.file_path)')
+    .action(async (options) => {
+    await knowledgeUsageHook(options);
+});
+// PostToolUse hook - knowledge references（知识溯源记录）
+program
+    .command('knowledge-references')
+    .description('PostToolUse hook - Record knowledge references during tech-design/proposal/apply')
+    .option('--json', 'Output as JSON for Claude Code consumption')
+    .action(async (options) => {
+    await knowledgeReferencesHook(options);
+});
+// Stop hook
+program
+    .command('summarize')
+    .description('Stop hook - Summarize session progress')
+    .option('--json', 'Output as JSON for Claude Code consumption')
+    .action(async (options) => {
+    await summarizeHook(options);
+});
+// UserPromptSubmit hook - record user input & activate correctionContext from phaseBaselines
+program
+    .command('user-input')
+    .description('UserPromptSubmit hook - Record user input and activate correction context post-baseline')
+    .option('--json', 'Output as JSON for Claude Code consumption (envelope printed regardless)')
+    .action(async () => {
+    await runUserInputHook();
+});
+program
+    .command('pre-archive')
+    .description('Pre-archive quality gate')
+    .option('--json', 'Output as JSON for Claude Code consumption')
+    .option('--change <id>', 'Change ID to validate before archive')
+    .action(async (options) => {
+    await preArchiveHook(options);
+});
+program
+    .command('post-archive')
+    .description('Post-archive knowledge update')
+    .option('--json', 'Output as JSON for Claude Code consumption')
+    .option('--archived <id>', 'Archived change ID')
+    .action(async (options) => {
+    await postArchiveHook(options);
+});
+// Pre-Apply hook - quality gate before entering Apply phase
+program
+    .command('pre-apply')
+    .description('Pre-Apply quality gate - validate change readiness before Apply phase')
+    .option('--json', 'Output as JSON for Claude Code consumption')
+    .option('--change <id>', 'Change ID to validate')
+    .action(async (options) => {
+    await preApplyHook(options);
+});
+// Post-Apply hook - deviation detection and auto-trigger review
+program
+    .command('post-apply')
+    .description('Post-Apply hook - detect deviations and trigger automatic review')
+    .option('--json', 'Output as JSON for Claude Code consumption')
+    .option('--change <id>', 'Change ID that was applied')
+    .action(async (options) => {
+    await postApplyHook(options);
+});
+// Phase Transition Check - Unified phase transition quality gate
+program
+    .command('phase-transition-check')
+    .description('Check phase transition conditions before moving to next phase')
+    .option('--json', 'Output as JSON for Claude Code consumption')
+    .option('--from <phase>', 'Current phase: propose|apply|review')
+    .option('--to <phase>', 'Target phase: apply|review|archive')
+    .option('--change <id>', 'Change ID being transitioned')
+    .action(async (options) => {
+    const result = await runPhaseTransitionCheck(options);
+    if (options.json) {
+        console.log(JSON.stringify(result));
+    }
+    else {
+        console.log(result.systemMessage || '');
+        if (!result.continue) {
+            process.exit(1);
+        }
+    }
+});
+// ============================================================
+// Review Phase Hooks - Check skill outputs and control fix loops
+// ============================================================
+// Code Review Result Check - Hook after code-review-expert skill
+program
+    .command('review-code-check')
+    .description('Check code-review-expert skill output and decide fix loop')
+    .option('--json', 'Output as JSON for Claude Code consumption')
+    .option('--change <id>', 'Change ID being reviewed')
+    .option('--output <json>', 'Skill output JSON (passed via stdin or option)')
+    .action(async (options) => {
+    const result = await codeReviewResultCheck(options.change || '', options.output ? JSON.parse(options.output) : undefined);
+    if (options.json) {
+        console.log(JSON.stringify(result));
+    }
+    else {
+        console.log(`Code Review: ${result.pass ? '✅ PASS' : '❌ FAIL'}`);
+        if (result.fixPrompt) {
+            console.log(result.fixPrompt);
+        }
+        if (!result.pass && result.nextAction === 'stop') {
+            process.exit(1);
+        }
+    }
+});
+// Unit Test Result Check - Hook after generate-mockito-unit-test-skill
+program
+    .command('review-unit-test-check')
+    .description('Check unit test skill output and decide fix loop')
+    .option('--json', 'Output as JSON for Claude Code consumption')
+    .option('--change <id>', 'Change ID being reviewed')
+    .option('--output <json>', 'Skill output JSON')
+    .action(async (options) => {
+    const result = await unitTestResultCheck(options.change || '', options.output ? JSON.parse(options.output) : undefined);
+    if (options.json) {
+        console.log(JSON.stringify(result));
+    }
+    else {
+        console.log(`Unit Test: ${result.pass ? '✅ PASS' : '❌ FAIL'}`);
+        console.log(`Coverage: ${result.metrics.coverage || 0}%`);
+        if (result.fixPrompt) {
+            console.log(result.fixPrompt);
+        }
+        if (!result.pass && result.nextAction === 'stop') {
+            process.exit(1);
+        }
+    }
+});
+// Spec-Code Consistency Check - Hook after spec-code-consistency check
+program
+    .command('review-spec-check')
+    .description('Check spec-code consistency output and decide fix loop')
+    .option('--json', 'Output as JSON for Claude Code consumption')
+    .option('--change <id>', 'Change ID being reviewed')
+    .option('--output <json>', 'Skill output JSON')
+    .action(async (options) => {
+    const result = await specConsistencyResultCheck(options.change || '', options.output ? JSON.parse(options.output) : undefined);
+    if (options.json) {
+        console.log(JSON.stringify(result));
+    }
+    else {
+        console.log(`Spec-Code Consistency: ${result.pass ? '✅ PASS' : '❌ FAIL'}`);
+        console.log(`Consistency Rate: ${result.metrics.consistencyRate || 0}%`);
+        if (result.fixPrompt) {
+            console.log(result.fixPrompt);
+        }
+        if (!result.pass && result.nextAction === 'stop') {
+            process.exit(1);
+        }
+    }
+});
+// Generate Review Report - Combine all three check results
+program
+    .command('review-report')
+    .description('Generate review report from all three check results')
+    .option('--json', 'Output as JSON for Claude Code consumption')
+    .option('--change <id>', 'Change ID being reviewed')
+    .action(async (options) => {
+    const changeId = options.change || '';
+    // Run all three checks
+    const codeReviewResult = await codeReviewResultCheck(changeId);
+    const unitTestResult = await unitTestResultCheck(changeId);
+    const specConsistencyResult = await specConsistencyResultCheck(changeId);
+    // Generate report
+    const report = await generateReviewReport(changeId, {
+        codeReview: codeReviewResult,
+        unitTest: unitTestResult,
+        specConsistency: specConsistencyResult,
+    });
+    if (options.json) {
+        console.log(JSON.stringify({
+            changeId,
+            overallPass: codeReviewResult.pass && unitTestResult.pass && specConsistencyResult.pass,
+            codeReview: codeReviewResult,
+            unitTest: unitTestResult,
+            specConsistency: specConsistencyResult,
+            reportPath: `zhuanspec/changes/${changeId}/review/review-report.md`,
+        }));
+    }
+    else {
+        console.log(report);
+        const overallPass = codeReviewResult.pass && unitTestResult.pass && specConsistencyResult.pass;
+        if (!overallPass) {
+            console.log('\n❌ Review NOT passed. Please fix issues before archiving.');
+            process.exit(1);
+        }
+        else {
+            console.log('\n✅ Review passed. Ready for Phase 4 (Archive).');
+        }
+    }
+});
+// Diagnostic command - inspect hook registration and trigger map
+program
+    .command('status')
+    .description('Show hook registration status and trigger mapping')
+    .option('--json', 'Output as JSON')
+    .action(async (options) => {
+    const summary = await collectHookStatus();
+    if (options.json) {
+        console.log(JSON.stringify(summary, null, 2));
+        return;
+    }
+    console.log(`settings: ${summary.settingsPath}`);
+    console.log(`settings exists: ${summary.settingsExists ? 'yes' : 'no'}`);
+    console.log('\n直接注册（Claude 生命周期 hooks）:');
+    if (summary.registeredLifecycleHooks.length === 0) {
+        console.log('- 无');
+    }
+    else {
+        for (const item of summary.registeredLifecycleHooks) {
+            console.log(`- ${item.phase}: ${item.command}`);
+        }
+    }
+    console.log('\n重复注册检测:');
+    if (summary.duplicates.length === 0) {
+        console.log('- 未发现重复');
+    }
+    else {
+        for (const item of summary.duplicates) {
+            console.log(`- ${item.phase}: ${item.command} (x${item.count})`);
+        }
+    }
+    console.log('\n间接触发（阶段门禁与 Review 链路）:');
+    for (const item of summary.phaseCommands) {
+        console.log(`- ${item.command}: ${item.trigger}`);
+    }
+});
+/**
+ * Phase Transition Check - Unified function for phase transition validation
+ */
+export async function runPhaseTransitionCheck(options) {
+    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 || '';
+    if (!changeId) {
+        return {
+            continue: false,
+            systemMessage: 'Phase transition check skipped: no change ID provided',
+        };
+    }
+    const changeDir = path.join(cwd, 'zhuanspec', 'changes', changeId);
+    // Determine target phase if not specified
+    let targetPhase = toPhase;
+    if (!targetPhase) {
+        switch (fromPhase) {
+            case 'propose':
+                targetPhase = 'apply';
+                break;
+            case 'apply':
+                targetPhase = 'review';
+                break;
+            case 'review':
+                targetPhase = 'archive';
+                break;
+            default:
+                targetPhase = 'apply';
+        }
+    }
+    // === Phase 准确率确认门禅（Task 4）===
+    // 规则：上一 phase 存在 phaseAccuracy 桶但未 confirmed 时阻断，
+    // systemMessage 指引 AI 调 AskUserQuestion 与 show-phase-accuracy / override-phase / confirm-phase 纠正。
+    // 绕过方式：环境变量 ZHUANSPEC_SKIP_ACCURACY_CONFIRM=1（CI/自动化用）。
+    const SKIP_CONFIRM = process.env.ZHUANSPEC_SKIP_ACCURACY_CONFIRM === '1';
+    const CONFIRMABLE_PHASES = new Set(['techDesign', 'propose', 'apply', 'review']);
+    if (!SKIP_CONFIRM && CONFIRMABLE_PHASES.has(fromPhase)) {
+        try {
+            const progressPath = path.join(changeDir, 'metrics', 'progress.json');
+            if (await FileSystemUtils.fileExists(progressPath)) {
+                const progressRaw = await FileSystemUtils.readFile(progressPath);
+                const progress = JSON.parse(progressRaw);
+                const buckets = progress.accuracy?.phaseAccuracy?.filter(b => b.phase === fromPhase) ?? [];
+                if (buckets.length > 0) {
+                    const unconfirmed = buckets.filter(b => !b.confirmed);
+                    if (unconfirmed.length > 0) {
+                        // 聚合展示
+                        const aiTotal = buckets.reduce((s, b) => s + (b.aiTotalLines || 0), 0);
+                        const correction = buckets.reduce((s, b) => s + (b.userCorrectionLines || 0), 0);
+                        const avgRate = buckets.length > 0
+                            ? buckets.reduce((s, b) => s + (b.accuracyRate || 0), 0) / buckets.length
+                            : 1;
+                        const rateStr = (avgRate * 100).toFixed(2);
+                        return {
+                            continue: false,
+                            requiresUserConfirmation: true,
+                            systemMessage: [
+                                `✗ Phase transition blocked: ${fromPhase} → ${targetPhase}`,
+                                '',
+                                `阶段 ${fromPhase} 的准确率尚未被用户确认（桶数=${buckets.length}，未确认=${unconfirmed.length}）。`,
+                                `当前数据：rate=${rateStr}%, AI产出=${aiTotal} 行, 用户纠偏=${correction} 行`,
+                                '',
+                                '请按以下步骤完成确认：',
+                                `1. 查看详细数据：zhuanspec progress show-phase-accuracy ${changeId} ${fromPhase}`,
+                                `2. 向用户提问（AskUserQuestion 或宿主等效工具）：`,
+                                `   问题：“${fromPhase} 阶段准确率为 ${rateStr}%（AI 产出 ${aiTotal} 行，纠偏 ${correction} 行），是否正确？”`,
+                                `   选项A 准确或已内消 → zhuanspec progress confirm-phase ${changeId} ${fromPhase}`,
+                                `   选项B 需纠正       → 询问正确率 rate 与原因 reason`,
+                                `        → zhuanspec progress override-phase ${changeId} ${fromPhase} --rate <0..1> --reason <text>`,
+                                `        → zhuanspec progress confirm-phase ${changeId} ${fromPhase}`,
+                                '3. 确认完成后重新运行 phase-transition-check。',
+                                '',
+                                '绕过本门禅（CI/自动化）：设置 ZHUANSPEC_SKIP_ACCURACY_CONFIRM=1。',
+                            ].join('\n'),
+                        };
+                    }
+                }
+                // 历史数据 / 无桶：跳过此门禅（fall-through 继续其他检查）
+            }
+        }
+        catch {
+            // 读取 progress.json 失败不阻断原有检查链路
+        }
+    }
+    // Execute appropriate pre-check based on target phase
+    switch (targetPhase) {
+        case 'apply':
+            // Propose → Apply: Run pre-apply checks
+            const preApplyResult = await checkPreApplyConditions(changeDir);
+            if (preApplyResult.continue) {
+                return {
+                    continue: true,
+                    systemMessage: `✓ Phase transition approved: ${fromPhase} → ${targetPhase}\n\nAll pre-apply checks passed. You may now proceed to Apply phase.`,
+                    checks: preApplyResult.checks,
+                };
+            }
+            return {
+                continue: false,
+                systemMessage: `✗ Phase transition blocked: ${fromPhase} → ${targetPhase}\n\n${preApplyResult.systemMessage}`,
+                checks: preApplyResult.checks,
+            };
+        case 'review':
+            // Apply → Review: Run post-apply deviation check
+            const postApplyResult = await executePostApply(changeDir, cwd);
+            if (postApplyResult.hookSpecificOutput?.deviationDetected) {
+                return {
+                    continue: false,
+                    systemMessage: `✗ Phase transition blocked: ${fromPhase} → ${targetPhase}\n\nDeviation detected: ${postApplyResult.hookSpecificOutput.deviationFiles?.length || 0} files outside proposal scope.\nPlease update proposal (Reverse Sync) before proceeding to Review.`,
+                };
+            }
+            return {
+                continue: true,
+                systemMessage: `✓ Phase transition approved: ${fromPhase} → ${targetPhase}\n\nNo deviations detected. Review phase can proceed.`,
+            };
+        case 'archive':
+            // Review → Archive: Check for review completion
+            const reviewDir = path.join(changeDir, 'review');
+            const reviewPath = path.join(reviewDir, 'code-review-result.json');
+            const testsPath = path.join(reviewDir, 'unit-test-result.json');
+            const reportPath = path.join(reviewDir, 'review-report.md');
+            const checks = {
+                reviewCompleted: false,
+                testsCompleted: false,
+                reportExists: false,
+            };
+            checks.reviewCompleted = await FileSystemUtils.fileExists(reviewPath);
+            checks.testsCompleted = await FileSystemUtils.fileExists(testsPath);
+            checks.reportExists = await FileSystemUtils.fileExists(reportPath);
+            if (!checks.reviewCompleted || !checks.testsCompleted || !checks.reportExists) {
+                const missing = [];
+                if (!checks.reviewCompleted)
+                    missing.push('review/code-review-result.json');
+                if (!checks.testsCompleted)
+                    missing.push('review/unit-test-result.json');
+                if (!checks.reportExists)
+                    missing.push('review/review-report.md');
+                return {
+                    continue: false,
+                    systemMessage: `✗ Phase transition blocked: ${fromPhase} → ${targetPhase}\n\nMissing review artifacts:\n${missing.map(m => `- ${m}`).join('\n')}\n\nPlease complete Review phase before archiving.`,
+                    checks,
+                };
+            }
+            return {
+                continue: true,
+                systemMessage: `✓ Phase transition approved: ${fromPhase} → ${targetPhase}\n\nAll review artifacts present. Archive phase can proceed.`,
+                checks,
+            };
+        default:
+            return {
+                continue: false,
+                systemMessage: `Unknown target phase: ${targetPhase}`,
+            };
+    }
+}
+async function collectHookStatus() {
+    const cwd = resolveZhuanSpecRoot();
+    const settingsPath = path.join(cwd, '.claude', 'settings.json');
+    const settingsExists = await FileSystemUtils.fileExists(settingsPath);
+    const registeredLifecycleHooks = [];
+    const duplicates = [];
+    if (settingsExists) {
+        try {
+            const content = await FileSystemUtils.readFile(settingsPath);
+            const parsed = JSON.parse(content);
+            const hooks = parsed.hooks ?? {};
+            for (const [phase, phaseConfigs] of Object.entries(hooks)) {
+                if (!Array.isArray(phaseConfigs))
+                    continue;
+                const commandCounts = new Map();
+                for (const phaseConfig of phaseConfigs) {
+                    const hooksArray = phaseConfig.hooks;
+                    if (!Array.isArray(hooksArray))
+                        continue;
+                    for (const hookItem of hooksArray) {
+                        const command = hookItem.command;
+                        if (typeof command !== 'string')
+                            continue;
+                        registeredLifecycleHooks.push({ phase, command });
+                        commandCounts.set(command, (commandCounts.get(command) ?? 0) + 1);
+                    }
+                }
+                for (const [command, count] of commandCounts.entries()) {
+                    if (count > 1) {
+                        duplicates.push({ phase, command, count });
+                    }
+                }
+            }
+        }
+        catch {
+            // Keep defaults; command should still provide guidance.
+        }
+    }
+    const phaseCommands = [
+        {
+            command: 'zhuanspec-hook pre-apply',
+            trigger: '由 deviation-check 内部调用 checkPreApplyConditions（Propose → Apply 前门禁）',
+        },
+        {
+            command: 'zhuanspec-hook post-apply',
+            trigger: '由 summarize/executePostApply 间接触发（Apply 完成后偏差检测与 review 触发）',
+        },
+        {
+            command: 'zhuanspec-hook review-code-check',
+            trigger: '由 zhuanspec review 结果链路调用（代码审查结果判定）',
+        },
+        {
+            command: 'zhuanspec-hook review-unit-test-check',
+            trigger: '由 zhuanspec review 结果链路调用（单测结果判定）',
+        },
+        {
+            command: 'zhuanspec-hook review-spec-check',
+            trigger: '由 zhuanspec review 结果链路调用（Spec/Code 一致性判定）',
+        },
+    ];
+    return {
+        settingsPath,
+        settingsExists,
+        registeredLifecycleHooks,
+        duplicates,
+        phaseCommands,
+    };
+}
+program.parse();
+//# sourceMappingURL=hooks.js.map