@zhuan-ai/zhuanspec 1.3.0

package/dist/core/init.js

@@ -0,0 +1,861 @@
+import path from 'path';
+import os from 'os';
+import { existsSync, mkdtempSync, readdirSync, readFileSync, rmSync } from 'fs';
+import { createPrompt, isBackspaceKey, isDownKey, isEnterKey, isSpaceKey, isUpKey, useKeypress, usePagination, useState, } from '@inquirer/core';
+import chalk from 'chalk';
+import ora from 'ora';
+import { execSync } from 'child_process';
+import { FileSystemUtils } from '../utils/file-system.js';
+import { TemplateManager } from './templates/index.js';
+import { ToolRegistry } from './configurators/registry.js';
+import { SlashCommandRegistry } from './configurators/slash/registry.js';
+import { AI_TOOLS, ZHUANSPEC_DIR_NAME, ZHUANSPEC_MARKERS, } from './config.js';
+import { PALETTE } from './styles/palette.js';
+const PROGRESS_SPINNER = {
+    interval: 80,
+    frames: ['░░░', '▒░░', '▒▒░', '▒▒▒', '▓▒▒', '▓▓▒', '▓▓▓', '▒▓▓', '░▒▓'],
+};
+const LETTER_MAP = {
+    O: [' ████ ', '██  ██', '██  ██', '██  ██', ' ████ '],
+    P: ['█████ ', '██  ██', '█████ ', '██    ', '██    '],
+    E: ['██████', '██    ', '█████ ', '██    ', '██████'],
+    N: ['██  ██', '███ ██', '██ ███', '██  ██', '██  ██'],
+    S: [' █████', '██    ', ' ████ ', '    ██', '█████ '],
+    C: [' █████', '██    ', '██    ', '██    ', ' █████'],
+    ' ': ['  ', '  ', '  ', '  ', '  '],
+};
+const sanitizeToolLabel = (raw) => raw.replace(/✅/gu, '✔').trim();
+const parseToolLabel = (raw) => {
+    const sanitized = sanitizeToolLabel(raw);
+    const match = sanitized.match(/^(.*?)\s*\((.+)\)$/u);
+    if (!match) {
+        return { primary: sanitized };
+    }
+    return {
+        primary: match[1].trim(),
+        annotation: match[2].trim(),
+    };
+};
+const isSelectableChoice = (choice) => choice.selectable;
+const ROOT_STUB_CHOICE_VALUE = '__root_stub__';
+const OTHER_TOOLS_HEADING_VALUE = '__heading-other__';
+const LIST_SPACER_VALUE = '__list-spacer__';
+const ARCH_REPO_URL = 'http://gitlab.zhuanspirit.com/zz-kf/spec_repo.git';
+const ARCH_REPO_BRANCH = 'spec_repo-feature-6612-2';
+const toolSelectionWizard = createPrompt((config, done) => {
+    const totalSteps = 3;
+    const [step, setStep] = useState('intro');
+    const selectableChoices = config.choices.filter(isSelectableChoice);
+    const initialCursorIndex = config.choices.findIndex((choice) => choice.selectable);
+    const [cursor, setCursor] = useState(initialCursorIndex === -1 ? 0 : initialCursorIndex);
+    const [selected, setSelected] = useState(() => {
+        const initial = new Set((config.initialSelected ?? []).filter((value) => selectableChoices.some((choice) => choice.value === value)));
+        return selectableChoices
+            .map((choice) => choice.value)
+            .filter((value) => initial.has(value));
+    });
+    const [error, setError] = useState(null);
+    const selectedSet = new Set(selected);
+    const pageSize = Math.max(config.choices.length, 1);
+    const updateSelected = (next) => {
+        const ordered = selectableChoices
+            .map((choice) => choice.value)
+            .filter((value) => next.has(value));
+        setSelected(ordered);
+    };
+    const page = usePagination({
+        items: config.choices,
+        active: cursor,
+        pageSize,
+        loop: false,
+        renderItem: ({ item, isActive }) => {
+            if (!item.selectable) {
+                const prefix = item.kind === 'info' ? '  ' : '';
+                const textColor = item.kind === 'heading' ? PALETTE.lightGray : PALETTE.midGray;
+                return `${PALETTE.midGray(' ')} ${PALETTE.midGray(' ')} ${textColor(`${prefix}${item.label.primary}`)}`;
+            }
+            const isSelected = selectedSet.has(item.value);
+            const cursorSymbol = isActive
+                ? PALETTE.white('›')
+                : PALETTE.midGray(' ');
+            const indicator = isSelected
+                ? PALETTE.white('◉')
+                : PALETTE.midGray('○');
+            const nameColor = isActive ? PALETTE.white : PALETTE.midGray;
+            const annotation = item.label.annotation
+                ? PALETTE.midGray(` (${item.label.annotation})`)
+                : '';
+            const configuredNote = item.configured
+                ? PALETTE.midGray(' (已配置)')
+                : '';
+            const label = `${nameColor(item.label.primary)}${annotation}${configuredNote}`;
+            return `${cursorSymbol} ${indicator} ${label}`;
+        },
+    });
+    const moveCursor = (direction) => {
+        if (selectableChoices.length === 0) {
+            return;
+        }
+        let nextIndex = cursor;
+        while (true) {
+            nextIndex = nextIndex + direction;
+            if (nextIndex < 0 || nextIndex >= config.choices.length) {
+                return;
+            }
+            if (config.choices[nextIndex]?.selectable) {
+                setCursor(nextIndex);
+                return;
+            }
+        }
+    };
+    useKeypress((key) => {
+        if (step === 'intro') {
+            if (isEnterKey(key)) {
+                setStep('select');
+            }
+            return;
+        }
+        if (step === 'select') {
+            if (isUpKey(key)) {
+                moveCursor(-1);
+                setError(null);
+                return;
+            }
+            if (isDownKey(key)) {
+                moveCursor(1);
+                setError(null);
+                return;
+            }
+            if (isSpaceKey(key)) {
+                const current = config.choices[cursor];
+                if (!current || !current.selectable)
+                    return;
+                const next = new Set(selected);
+                if (next.has(current.value)) {
+                    next.delete(current.value);
+                }
+                else {
+                    next.add(current.value);
+                }
+                updateSelected(next);
+                setError(null);
+                return;
+            }
+            if (isEnterKey(key)) {
+                const current = config.choices[cursor];
+                if (current &&
+                    current.selectable &&
+                    !selectedSet.has(current.value)) {
+                    const next = new Set(selected);
+                    next.add(current.value);
+                    updateSelected(next);
+                }
+                setStep('review');
+                setError(null);
+                return;
+            }
+            if (key.name === 'escape') {
+                const next = new Set();
+                updateSelected(next);
+                setError(null);
+            }
+            return;
+        }
+        if (step === 'review') {
+            if (isEnterKey(key)) {
+                const finalSelection = config.choices
+                    .map((choice) => choice.value)
+                    .filter((value) => selectedSet.has(value) && value !== ROOT_STUB_CHOICE_VALUE);
+                done(finalSelection);
+                return;
+            }
+            if (isBackspaceKey(key) || key.name === 'escape') {
+                setStep('select');
+                setError(null);
+            }
+        }
+    });
+    const rootStubChoice = selectableChoices.find((choice) => choice.value === ROOT_STUB_CHOICE_VALUE);
+    const rootStubSelected = rootStubChoice
+        ? selectedSet.has(ROOT_STUB_CHOICE_VALUE)
+        : false;
+    const nativeChoices = selectableChoices.filter((choice) => choice.value !== ROOT_STUB_CHOICE_VALUE);
+    const selectedNativeChoices = nativeChoices.filter((choice) => selectedSet.has(choice.value));
+    const formatSummaryLabel = (choice) => {
+        const annotation = choice.label.annotation
+            ? PALETTE.midGray(` (${choice.label.annotation})`)
+            : '';
+        const configuredNote = choice.configured
+            ? PALETTE.midGray(' (already configured)')
+            : '';
+        return `${PALETTE.white(choice.label.primary)}${annotation}${configuredNote}`;
+    };
+    const stepIndex = step === 'intro' ? 1 : step === 'select' ? 2 : 3;
+    const lines = [];
+    lines.push(PALETTE.midGray(`Step ${stepIndex}/${totalSteps}`));
+    lines.push('');
+    if (step === 'intro') {
+        const introHeadline = config.extendMode
+            ? 'Extend your ZhuanSpec tooling'
+            : 'Configure your ZhuanSpec tooling';
+        const introBody = config.extendMode
+            ? 'We detected an existing setup. We will help you refresh or add integrations.'
+            : "Let's get your AI assistants connected so they understand ZhuanSpec.";
+        lines.push(PALETTE.white(introHeadline));
+        lines.push(PALETTE.midGray(introBody));
+        lines.push('');
+        lines.push(PALETTE.midGray('Press Enter to continue.'));
+    }
+    else if (step === 'select') {
+        lines.push(PALETTE.white(config.baseMessage));
+        lines.push(PALETTE.midGray('Use ↑/↓ to move · Space to toggle · Enter selects highlighted tool and reviews.'));
+        lines.push('');
+        lines.push(page);
+        lines.push('');
+        lines.push(PALETTE.midGray('Selected configuration:'));
+        if (rootStubSelected && rootStubChoice) {
+            lines.push(`  ${PALETTE.white('-')} ${formatSummaryLabel(rootStubChoice)}`);
+        }
+        if (selectedNativeChoices.length === 0) {
+            lines.push(`  ${PALETTE.midGray('- 未选择原生支持的提供者')}`);
+        }
+        else {
+            selectedNativeChoices.forEach((choice) => {
+                lines.push(`  ${PALETTE.white('-')} ${formatSummaryLabel(choice)}`);
+            });
+        }
+    }
+    else {
+        lines.push(PALETTE.white('审查选择'));
+        lines.push(PALETTE.midGray('按 Enter 确认或按 Backspace 调整。'));
+        lines.push('');
+        if (rootStubSelected && rootStubChoice) {
+            lines.push(`${PALETTE.white('▌')} ${formatSummaryLabel(rootStubChoice)}`);
+        }
+        if (selectedNativeChoices.length === 0) {
+            lines.push(PALETTE.midGray('未选择原生支持的提供者。仍将应用通用说明。'));
+        }
+        else {
+            selectedNativeChoices.forEach((choice) => {
+                lines.push(`${PALETTE.white('▌')} ${formatSummaryLabel(choice)}`);
+            });
+        }
+    }
+    if (error) {
+        return [lines.join('\n'), chalk.red(error)];
+    }
+    return lines.join('\n');
+});
+export class InitCommand {
+    prompt;
+    toolsArg;
+    businessDirection;
+    constructor(options = {}) {
+        this.prompt = options.prompt ?? ((config) => toolSelectionWizard(config));
+        this.toolsArg = options.tools;
+        this.businessDirection = options.businessDirection;
+    }
+    async execute(targetPath) {
+        const projectPath = path.resolve(targetPath);
+        const zhuanspecDir = ZHUANSPEC_DIR_NAME;
+        const zhuanspecPath = path.join(projectPath, zhuanspecDir);
+        // Validation happens silently in the background
+        const extendMode = await this.validate(projectPath, zhuanspecPath);
+        const existingToolStates = await this.getExistingToolStates(projectPath, extendMode);
+        this.renderBanner(extendMode);
+        // Get configuration (after validation to avoid prompts if validation fails)
+        const config = await this.getConfiguration(existingToolStates, extendMode);
+        const availableTools = AI_TOOLS.filter((tool) => tool.available);
+        const selectedIds = new Set(config.aiTools);
+        const selectedTools = availableTools.filter((tool) => selectedIds.has(tool.value));
+        const created = selectedTools.filter((tool) => !existingToolStates[tool.value]);
+        const refreshed = selectedTools.filter((tool) => existingToolStates[tool.value]);
+        const skippedExisting = availableTools.filter((tool) => !selectedIds.has(tool.value) && existingToolStates[tool.value]);
+        const skipped = availableTools.filter((tool) => !selectedIds.has(tool.value) && !existingToolStates[tool.value]);
+        // Step 1: Create directory structure
+        if (!extendMode) {
+            const structureSpinner = this.startSpinner('正在创建 ZhuanSpec 结构...');
+            await this.createDirectoryStructure(zhuanspecPath);
+            await this.generateFiles(zhuanspecPath, config);
+            structureSpinner.stopAndPersist({
+                symbol: PALETTE.white('▌'),
+                text: PALETTE.white('ZhuanSpec 结构已创建'),
+            });
+        }
+        else {
+            ora({ stream: process.stdout }).info(PALETTE.midGray('ℹ ZhuanSpec 已初始化。正在检查缺失的文件...'));
+            await this.createDirectoryStructure(zhuanspecPath);
+            await this.ensureTemplateFiles(zhuanspecPath, config);
+        }
+        // Step 2: Configure AI tools
+        const toolSpinner = this.startSpinner('正在配置 AI 工具...');
+        const rootStubStatus = await this.configureAITools(projectPath, zhuanspecDir, config.aiTools);
+        toolSpinner.stopAndPersist({
+            symbol: PALETTE.white('▌'),
+            text: PALETTE.white('AI 工具已配置'),
+        });
+        // Step 3: Select business direction and apply architecture file
+        await this.promptForBusinessDirection();
+        if (this.businessDirection) {
+            const archSpinner = this.startSpinner(`正在获取 ${this.businessDirection} 业务架构文档...`);
+            const architectureContent = await this.fetchArchitectureFile();
+            if (architectureContent) {
+                const projectMdPath = path.join(zhuanspecPath, 'project.md');
+                const projectMdExists = await FileSystemUtils.fileExists(projectMdPath);
+                await FileSystemUtils.writeFile(projectMdPath, architectureContent);
+                archSpinner.stopAndPersist({
+                    symbol: PALETTE.white('▌'),
+                    text: PALETTE.white(projectMdExists
+                        ? `已使用 ${this.businessDirection} 业务架构文档覆盖 project.md`
+                        : `已应用 ${this.businessDirection} 业务架构文档到 project.md`),
+                });
+            }
+            else {
+                archSpinner.stopAndPersist({
+                    symbol: PALETTE.midGray('▌'),
+                    text: PALETTE.midGray(`未找到 ${this.businessDirection} 业务架构文档，使用默认模板`),
+                });
+            }
+        }
+        // Success message
+        this.displaySuccessMessage(selectedTools, created, refreshed, skippedExisting, skipped, extendMode, rootStubStatus);
+    }
+    async validate(projectPath, _zhuanspecPath) {
+        const extendMode = await FileSystemUtils.directoryExists(_zhuanspecPath);
+        // Check write permissions
+        if (!(await FileSystemUtils.ensureWritePermissions(projectPath))) {
+            throw new Error(`Insufficient permissions to write to ${projectPath}`);
+        }
+        return extendMode;
+    }
+    async getConfiguration(existingTools, extendMode) {
+        const selectedTools = await this.getSelectedTools(existingTools, extendMode);
+        return { aiTools: selectedTools };
+    }
+    async getSelectedTools(existingTools, extendMode) {
+        const nonInteractiveSelection = this.resolveToolsArg();
+        if (nonInteractiveSelection !== null) {
+            return nonInteractiveSelection;
+        }
+        // Fall back to interactive mode
+        return this.promptForAITools(existingTools, extendMode);
+    }
+    resolveToolsArg() {
+        if (typeof this.toolsArg === 'undefined') {
+            return null;
+        }
+        const raw = this.toolsArg.trim();
+        if (raw.length === 0) {
+            throw new Error('The --tools option requires a value. Use "all", "none", or a comma-separated list of tool IDs.');
+        }
+        const availableTools = AI_TOOLS.filter((tool) => tool.available);
+        const availableValues = availableTools.map((tool) => tool.value);
+        const availableSet = new Set(availableValues);
+        const availableList = ['all', 'none', ...availableValues].join(', ');
+        const lowerRaw = raw.toLowerCase();
+        if (lowerRaw === 'all') {
+            return availableValues;
+        }
+        if (lowerRaw === 'none') {
+            return [];
+        }
+        const tokens = raw
+            .split(',')
+            .map((token) => token.trim())
+            .filter((token) => token.length > 0);
+        if (tokens.length === 0) {
+            throw new Error('The --tools option requires at least one tool ID when not using "all" or "none".');
+        }
+        const normalizedTokens = tokens.map((token) => token.toLowerCase());
+        if (normalizedTokens.some((token) => token === 'all' || token === 'none')) {
+            throw new Error('Cannot combine reserved values "all" or "none" with specific tool IDs.');
+        }
+        const invalidTokens = tokens.filter((_token, index) => !availableSet.has(normalizedTokens[index]));
+        if (invalidTokens.length > 0) {
+            throw new Error(`Invalid tool(s): ${invalidTokens.join(', ')}. Available values: ${availableList}`);
+        }
+        const deduped = [];
+        for (const token of normalizedTokens) {
+            if (!deduped.includes(token)) {
+                deduped.push(token);
+            }
+        }
+        return deduped;
+    }
+    async promptForAITools(existingTools, extendMode) {
+        const availableTools = AI_TOOLS.filter((tool) => tool.available);
+        const baseMessage = extendMode
+            ? '您想添加或刷新哪些原生支持的 AI 工具？'
+            : '您使用哪些原生支持的 AI 工具？';
+        const initialNativeSelection = extendMode
+            ? availableTools
+                .filter((tool) => existingTools[tool.value])
+                .map((tool) => tool.value)
+            : [];
+        const initialSelected = Array.from(new Set(initialNativeSelection));
+        const choices = [
+            {
+                kind: 'heading',
+                value: '__heading-native__',
+                label: {
+                    primary: '原生支持的提供者（✔ 提供 ZhuanSpec 自定义斜杠命令）',
+                },
+                selectable: false,
+            },
+            ...availableTools.map((tool) => ({
+                kind: 'option',
+                value: tool.value,
+                label: parseToolLabel(tool.name),
+                configured: Boolean(existingTools[tool.value]),
+                selectable: true,
+            })),
+            ...(availableTools.length
+                ? [
+                    {
+                        kind: 'info',
+                        value: LIST_SPACER_VALUE,
+                        label: { primary: '' },
+                        selectable: false,
+                    },
+                ]
+                : []),
+            {
+                kind: 'heading',
+                value: OTHER_TOOLS_HEADING_VALUE,
+                label: {
+                    primary: '其他工具（为 Amp、VS Code、GitHub Copilot 等使用通用 AGENTS.md）',
+                },
+                selectable: false,
+            },
+            {
+                kind: 'option',
+                value: ROOT_STUB_CHOICE_VALUE,
+                label: {
+                    primary: '通用 AGENTS.md',
+                    annotation: '始终可用',
+                },
+                configured: extendMode,
+                selectable: true,
+            },
+        ];
+        return this.prompt({
+            extendMode,
+            baseMessage,
+            choices,
+            initialSelected,
+        });
+    }
+    async getExistingToolStates(projectPath, extendMode) {
+        // Fresh initialization - no tools configured yet
+        if (!extendMode) {
+            return Object.fromEntries(AI_TOOLS.map(t => [t.value, false]));
+        }
+        // Extend mode - check all tools in parallel for better performance
+        const entries = await Promise.all(AI_TOOLS.map(async (t) => [t.value, await this.isToolConfigured(projectPath, t.value)]));
+        return Object.fromEntries(entries);
+    }
+    async isToolConfigured(projectPath, toolId) {
+        // A tool is only considered "configured by ZhuanSpec" if its files contain ZhuanSpec markers.
+        // For tools with both config files and slash commands, BOTH must have markers.
+        // For slash commands, at least one file with markers is sufficient (not all required).
+        // Helper to check if a file exists and contains ZhuanSpec markers
+        const fileHasMarkers = async (absolutePath) => {
+            try {
+                const content = await FileSystemUtils.readFile(absolutePath);
+                return content.includes(ZHUANSPEC_MARKERS.start) && content.includes(ZHUANSPEC_MARKERS.end);
+            }
+            catch {
+                return false;
+            }
+        };
+        let hasConfigFile = false;
+        let hasSlashCommands = false;
+        // Check if the tool has a config file with ZhuanSpec markers
+        const configFile = ToolRegistry.get(toolId)?.configFileName;
+        if (configFile) {
+            const configPath = path.join(projectPath, configFile);
+            hasConfigFile = (await FileSystemUtils.fileExists(configPath)) && (await fileHasMarkers(configPath));
+        }
+        // Check if any slash command file exists with ZhuanSpec markers
+        const slashConfigurator = SlashCommandRegistry.get(toolId);
+        if (slashConfigurator) {
+            for (const target of slashConfigurator.getTargets()) {
+                const absolute = slashConfigurator.resolveAbsolutePath(projectPath, target.id);
+                if ((await FileSystemUtils.fileExists(absolute)) && (await fileHasMarkers(absolute))) {
+                    hasSlashCommands = true;
+                    break; // At least one file with markers is sufficient
+                }
+            }
+        }
+        // Tool is only configured if BOTH exist with markers
+        // OR if the tool has no config file requirement (slash commands only)
+        // OR if the tool has no slash commands requirement (config file only)
+        const hasConfigFileRequirement = configFile !== undefined;
+        const hasSlashCommandRequirement = slashConfigurator !== undefined;
+        if (hasConfigFileRequirement && hasSlashCommandRequirement) {
+            // Both are required - both must be present with markers
+            return hasConfigFile && hasSlashCommands;
+        }
+        else if (hasConfigFileRequirement) {
+            // Only config file required
+            return hasConfigFile;
+        }
+        else if (hasSlashCommandRequirement) {
+            // Only slash commands required
+            return hasSlashCommands;
+        }
+        return false;
+    }
+    async createDirectoryStructure(zhuanspecPath) {
+        const directories = [
+            zhuanspecPath,
+            path.join(zhuanspecPath, 'specs'),
+            path.join(zhuanspecPath, 'changes'),
+            path.join(zhuanspecPath, 'changes', 'archive'),
+        ];
+        for (const dir of directories) {
+            await FileSystemUtils.createDirectory(dir);
+        }
+    }
+    async generateFiles(zhuanspecPath, config) {
+        await this.writeTemplateFiles(zhuanspecPath, config, false);
+    }
+    async ensureTemplateFiles(zhuanspecPath, config) {
+        await this.writeTemplateFiles(zhuanspecPath, config, true);
+    }
+    getRepoCwd() {
+        const moduleDir = path.dirname(new URL(import.meta.url).pathname);
+        const zhuanspecRoot = path.resolve(moduleDir, '..', '..');
+        return path.resolve(zhuanspecRoot, '..');
+    }
+    fetchAvailableBusinessDirections() {
+        const dedupe = (items) => Array.from(new Set(items)).sort();
+        const remoteFiles = this.fetchRemoteArchitectureFiles();
+        const remoteDirections = remoteFiles
+            .map((f) => {
+            const match = f.match(/^(.+)_project_architect\.md$/);
+            return match ? match[1] : null;
+        })
+            .filter((d) => d !== null);
+        if (remoteDirections.length > 0) {
+            return dedupe(remoteDirections);
+        }
+        const repoCwd = this.getRepoCwd();
+        // Fallback: try git ls-tree from local branch/ref
+        try {
+            const output = execSync(`git ls-tree --name-only ${ARCH_REPO_BRANCH} specs/common/`, { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'ignore'], cwd: repoCwd });
+            const files = output.trim().split('\n').filter(Boolean);
+            const directions = files
+                .map((f) => {
+                const basename = path.basename(f);
+                const match = basename.match(/^(.+)_project_architect\.md$/);
+                return match ? match[1] : null;
+            })
+                .filter((d) => d !== null);
+            if (directions.length > 0) {
+                return dedupe(directions);
+            }
+        }
+        catch {
+            // Ignore
+        }
+        // Fallback: try current git HEAD tree
+        try {
+            const output = execSync('git ls-tree --name-only HEAD specs/common/', { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'ignore'], cwd: repoCwd });
+            const files = output.trim().split('\n').filter(Boolean);
+            const directions = files
+                .map((f) => {
+                const basename = path.basename(f);
+                const match = basename.match(/^(.+)_project_architect\.md$/);
+                return match ? match[1] : null;
+            })
+                .filter((d) => d !== null);
+            if (directions.length > 0) {
+                return dedupe(directions);
+            }
+        }
+        catch {
+            // Ignore
+        }
+        // Fallback: try local file system
+        try {
+            const commonDir = path.resolve(repoCwd, 'specs', 'common');
+            const entries = execSync(`ls ${commonDir}`, {
+                encoding: 'utf-8',
+                stdio: ['pipe', 'pipe', 'ignore'],
+            })
+                .trim()
+                .split('\n')
+                .filter(Boolean);
+            const directions = entries
+                .map((f) => {
+                const match = f.match(/^(.+)_project_architect\.md$/);
+                return match ? match[1] : null;
+            })
+                .filter((d) => d !== null);
+            if (directions.length > 0) {
+                return dedupe(directions);
+            }
+        }
+        catch {
+            // Ignore
+        }
+        // Keep interactive prompt useful even when discovery fails.
+        return ['oms', 'ass'];
+    }
+    async promptForBusinessDirection() {
+        if (this.businessDirection) {
+            return;
+        }
+        const directions = this.fetchAvailableBusinessDirections();
+        // Check if interactive mode is available
+        if (!process.stdin.isTTY || process.env.OPEN_SPEC_INTERACTIVE === '0' || 'CI' in process.env) {
+            return;
+        }
+        const { select, input } = await import('@inquirer/prompts');
+        const MANUAL_VALUE = '__manual__';
+        const choices = [
+            ...directions.map((d) => ({
+                name: d,
+                value: d,
+            })),
+            {
+                name: '手动输入业务方向',
+                value: MANUAL_VALUE,
+            },
+            {
+                name: '跳过（使用默认模板）',
+                value: '__skip__',
+            },
+        ];
+        const answer = await select({
+            message: '请选择业务方向（用于获取项目架构文档）',
+            choices,
+        });
+        if (answer === MANUAL_VALUE) {
+            const manualDirection = (await input({
+                message: '请输入业务方向（例如 oms）',
+            })).trim();
+            if (manualDirection) {
+                this.businessDirection = manualDirection;
+            }
+            return;
+        }
+        if (answer !== '__skip__') {
+            this.businessDirection = answer;
+        }
+    }
+    async fetchArchitectureFile() {
+        if (!this.businessDirection) {
+            return null;
+        }
+        const fileName = `${this.businessDirection}_project_architect.md`;
+        const filePath = `specs/common/${fileName}`;
+        const remoteContent = this.fetchRemoteArchitectureContent(fileName);
+        if (remoteContent && remoteContent.trim()) {
+            return remoteContent.trim();
+        }
+        const repoCwd = this.getRepoCwd();
+        // Fallback: try git show from local repository branch/ref
+        try {
+            const content = execSync(`git show ${ARCH_REPO_BRANCH}:${filePath}`, { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'ignore'], cwd: repoCwd });
+            if (content && content.trim()) {
+                return content.trim();
+            }
+        }
+        catch {
+            // Ignore
+        }
+        // Try reading from local file system
+        try {
+            const localPath = path.resolve(repoCwd, filePath);
+            if (await FileSystemUtils.fileExists(localPath)) {
+                return await FileSystemUtils.readFile(localPath);
+            }
+        }
+        catch {
+            // Ignore
+        }
+        return null;
+    }
+    fetchRemoteArchitectureFiles() {
+        const tempDir = mkdtempSync(path.join(os.tmpdir(), 'zhuanspec-arch-'));
+        try {
+            execSync(`git clone --depth 1 --single-branch --branch ${ARCH_REPO_BRANCH} ${ARCH_REPO_URL} "${tempDir}"`, { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'ignore'] });
+            const commonDir = path.join(tempDir, 'specs', 'common');
+            if (!existsSync(commonDir)) {
+                return [];
+            }
+            return readdirSync(commonDir).filter((name) => name.endsWith('_project_architect.md'));
+        }
+        catch {
+            return [];
+        }
+        finally {
+            rmSync(tempDir, { recursive: true, force: true });
+        }
+    }
+    fetchRemoteArchitectureContent(fileName) {
+        const tempDir = mkdtempSync(path.join(os.tmpdir(), 'zhuanspec-arch-'));
+        try {
+            execSync(`git clone --depth 1 --single-branch --branch ${ARCH_REPO_BRANCH} ${ARCH_REPO_URL} "${tempDir}"`, { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'ignore'] });
+            const fullPath = path.join(tempDir, 'specs', 'common', fileName);
+            if (!existsSync(fullPath)) {
+                return null;
+            }
+            return readFileSync(fullPath, 'utf-8');
+        }
+        catch {
+            return null;
+        }
+        finally {
+            rmSync(tempDir, { recursive: true, force: true });
+        }
+    }
+    async writeTemplateFiles(zhuanspecPath, config, skipExisting) {
+        const context = {};
+        const templates = TemplateManager.getTemplates(context);
+        for (const template of templates) {
+            const filePath = path.join(zhuanspecPath, template.path);
+            // Skip if file exists and we're in skipExisting mode
+            if (skipExisting && (await FileSystemUtils.fileExists(filePath))) {
+                continue;
+            }
+            const content = typeof template.content === 'function'
+                ? template.content(context)
+                : template.content;
+            await FileSystemUtils.writeFile(filePath, content);
+        }
+    }
+    async configureAITools(projectPath, zhuanspecDir, toolIds) {
+        const rootStubStatus = await this.configureRootAgentsStub(projectPath, zhuanspecDir);
+        for (const toolId of toolIds) {
+            const configurator = ToolRegistry.get(toolId);
+            if (configurator && configurator.isAvailable) {
+                await configurator.configure(projectPath, zhuanspecDir);
+            }
+            const slashConfigurator = SlashCommandRegistry.get(toolId);
+            if (slashConfigurator && slashConfigurator.isAvailable) {
+                await slashConfigurator.generateAll(projectPath, zhuanspecDir);
+            }
+        }
+        return rootStubStatus;
+    }
+    async configureRootAgentsStub(projectPath, zhuanspecDir) {
+        const configurator = ToolRegistry.get('agents');
+        if (!configurator || !configurator.isAvailable) {
+            return 'skipped';
+        }
+        const stubPath = path.join(projectPath, configurator.configFileName);
+        const existed = await FileSystemUtils.fileExists(stubPath);
+        await configurator.configure(projectPath, zhuanspecDir);
+        return existed ? 'updated' : 'created';
+    }
+    displaySuccessMessage(selectedTools, created, refreshed, skippedExisting, skipped, extendMode, rootStubStatus) {
+        console.log(); // Empty line for spacing
+        const successHeadline = extendMode
+            ? 'ZhuanSpec 工具配置已更新！'
+            : 'ZhuanSpec 初始化成功！';
+        ora().succeed(PALETTE.white(successHeadline));
+        console.log();
+        console.log(PALETTE.lightGray('工具摘要：'));
+        const summaryLines = [
+            rootStubStatus === 'created'
+                ? `${PALETTE.white('▌')} ${PALETTE.white('为其他助手创建了根目录 AGENTS.md 存根')}`
+                : null,
+            rootStubStatus === 'updated'
+                ? `${PALETTE.lightGray('▌')} ${PALETTE.lightGray('为其他助手刷新了根目录 AGENTS.md 存根')}`
+                : null,
+            created.length
+                ? `${PALETTE.white('▌')} ${PALETTE.white('已创建：')} ${this.formatToolNames(created)}`
+                : null,
+            refreshed.length
+                ? `${PALETTE.lightGray('▌')} ${PALETTE.lightGray('已刷新：')} ${this.formatToolNames(refreshed)}`
+                : null,
+            skippedExisting.length
+                ? `${PALETTE.midGray('▌')} ${PALETTE.midGray('已跳过（已配置）：')} ${this.formatToolNames(skippedExisting)}`
+                : null,
+            skipped.length
+                ? `${PALETTE.darkGray('▌')} ${PALETTE.darkGray('已跳过：')} ${this.formatToolNames(skipped)}`
+                : null,
+        ].filter((line) => Boolean(line));
+        for (const line of summaryLines) {
+            console.log(line);
+        }
+        console.log();
+        console.log(PALETTE.midGray('将来使用 `zhuanspec update` 刷新共享的 ZhuanSpec 说明。'));
+        // Show restart instruction if any tools were configured
+        if (created.length > 0 || refreshed.length > 0) {
+            console.log();
+            console.log(PALETTE.white('重要：请重启您的 IDE'));
+            console.log(PALETTE.midGray('斜杠命令在启动时加载。请重启您的编程助手'));
+            console.log(PALETTE.midGray('以确保新的 /zhuanspec 命令出现在命令面板中。'));
+        }
+        // Get the selected tool name(s) for display
+        const toolName = this.formatToolNames(selectedTools);
+        console.log();
+        console.log(`下一步 - 将这些提示复制到 ${toolName}：`);
+        console.log(chalk.gray('────────────────────────────────────────────────────────────'));
+        console.log(PALETTE.white('1. 填充您的项目上下文：'));
+        console.log(PALETTE.lightGray('   "请阅读 zhuanspec/project.md 并帮助我填写'));
+        console.log(PALETTE.lightGray('    有关我的项目、技术栈和约定的详细信息"\n'));
+        console.log(PALETTE.white('2. 创建您的第一个变更提案：'));
+        console.log(PALETTE.lightGray('   "我想添加 [您的功能]。请为此功能'));
+        console.log(PALETTE.lightGray('    创建一个 ZhuanSpec 变更提案"\n'));
+        console.log(PALETTE.white('3. 了解 ZhuanSpec 工作流：'));
+        console.log(PALETTE.lightGray('   "请解释 zhuanspec/AGENTS.md 中的 ZhuanSpec 工作流'));
+        console.log(PALETTE.lightGray('    以及我应该如何在这个项目上与您合作"'));
+        console.log(PALETTE.darkGray('────────────────────────────────────────────────────────────\n'));
+        // Codex heads-up: prompts installed globally
+        const selectedToolIds = new Set(selectedTools.map((t) => t.value));
+        if (selectedToolIds.has('codex')) {
+            console.log(PALETTE.white('Codex 设置说明'));
+            console.log(PALETTE.midGray('提示已安装到 ~/.codex/prompts（或 $CODEX_HOME/prompts）。'));
+            console.log();
+        }
+    }
+    formatToolNames(tools) {
+        const names = tools
+            .map((tool) => tool.successLabel ?? tool.name)
+            .filter((name) => Boolean(name));
+        if (names.length === 0)
+            return PALETTE.lightGray('your AGENTS.md-compatible assistant');
+        if (names.length === 1)
+            return PALETTE.white(names[0]);
+        const base = names.slice(0, -1).map((name) => PALETTE.white(name));
+        const last = PALETTE.white(names[names.length - 1]);
+        return `${base.join(PALETTE.midGray(', '))}${base.length ? PALETTE.midGray(', and ') : ''}${last}`;
+    }
+    renderBanner(_extendMode) {
+        const rows = ['', '', '', '', ''];
+        for (const char of 'ZHUANSPEC') {
+            const glyph = LETTER_MAP[char] ?? LETTER_MAP[' '];
+            for (let i = 0; i < rows.length; i += 1) {
+                rows[i] += `${glyph[i]}  `;
+            }
+        }
+        const rowStyles = [
+            PALETTE.white,
+            PALETTE.lightGray,
+            PALETTE.midGray,
+            PALETTE.lightGray,
+            PALETTE.white,
+        ];
+        console.log();
+        rows.forEach((row, index) => {
+            console.log(rowStyles[index](row.replace(/\s+$/u, '')));
+        });
+        console.log();
+        console.log(PALETTE.white('Welcome to ZhuanSpec!'));
+        console.log();
+    }
+    startSpinner(text) {
+        return ora({
+            text,
+            stream: process.stdout,
+            color: 'gray',
+            spinner: PROGRESS_SPINNER,
+        }).start();
+    }
+}
+//# sourceMappingURL=init.js.map