autosnippet 3.2.21 → 3.3.0

package/dist/lib/platform/ios/routes/spm.js

@@ -1,371 +0,0 @@
-/**
- * SPM API 路由 — 向后兼容层
- *
- * 所有端点统一委派到 ModuleService（语言无关模块扫描服务）。
- * SPM Discoverer 作为 ModuleService 的一个 discoverer 自动匹配 Swift/SPM 项目。
- * 新代码应直接使用 /api/v1/modules/* 端点。
- */
-import express from 'express';
-import { createStreamSession, getStreamSession } from '#http/utils/sse-sessions.js';
-import Logger from '#infra/logging/Logger.js';
-import { getServiceContainer } from '#inject/ServiceContainer.js';
-import { ValidationError } from '#shared/errors/index.js';
-const router = express.Router();
-const logger = Logger.getInstance();
-/** 获取 moduleService 并确保已加载 */
-async function getModuleService() {
-    const container = getServiceContainer();
-    const moduleService = container.get('moduleService');
-    await moduleService.load();
-    return moduleService;
-}
-/** GET /api/v1/spm/targets */
-router.get('/targets', async (req, res) => {
-    const moduleService = await getModuleService();
-    const targets = await moduleService.listTargets();
-    res.json({
-        success: true,
-        data: { targets, total: targets.length },
-    });
-});
-/** GET /api/v1/spm/dep-graph */
-router.get('/dep-graph', async (req, res) => {
-    const moduleService = await getModuleService();
-    const level = String(req.query.level || 'package');
-    const _graphBase = await moduleService.getDependencyGraph({ level });
-    const graph = _graphBase;
-    if (!graph || (!graph.nodes && !graph.packages)) {
-        res.json({
-            success: true,
-            data: { nodes: [], edges: [], projectRoot: null },
-        });
-        return;
-    }
-    // 标准化为 { nodes, edges } 格式
-    let nodes = [];
-    let edges = [];
-    if (graph.nodes && graph.edges) {
-        // 已经是标准格式
-        nodes = graph.nodes;
-        edges = graph.edges;
-    }
-    else if (graph.packages) {
-        // 从 packages 构建图
-        if (level === 'target') {
-            for (const [pkgName, pkgInfo] of Object.entries(graph.packages)) {
-                const targetsInfo = pkgInfo?.targetsInfo || {};
-                for (const [targetName, info] of Object.entries(targetsInfo)) {
-                    const id = `${pkgName}::${targetName}`;
-                    nodes.push({
-                        id,
-                        label: targetName,
-                        type: 'target',
-                        packageName: pkgName,
-                    });
-                    for (const d of info
-                        ?.dependencies || []) {
-                        if (!d?.name) {
-                            continue;
-                        }
-                        const depPkg = d?.package || pkgName;
-                        edges.push({ from: id, to: `${depPkg}::${d.name}`, source: 'base' });
-                    }
-                }
-            }
-        }
-        else {
-            const pkgs = graph.packages;
-            nodes = Object.keys(pkgs).map((id) => ({
-                id,
-                label: id,
-                type: 'package',
-                packageDir: pkgs[id]?.packageDir,
-                targets: pkgs[id]?.targets,
-            }));
-            for (const [from, tos] of Object.entries(graph.edges || {})) {
-                for (const to of tos || []) {
-                    edges.push({ from, to, source: 'base' });
-                }
-            }
-        }
-    }
-    res.json({
-        success: true,
-        data: {
-            nodes,
-            edges,
-            projectRoot: graph.projectRoot || null,
-            generatedAt: graph.generatedAt || null,
-        },
-    });
-});
-/**
- * POST /api/v1/spm/target-files
- * 获取 Target 的文件列表
- */
-router.post('/target-files', async (req, res) => {
-    const { target, targetName } = req.body;
-    if (!target && !targetName) {
-        throw new ValidationError('target object or targetName is required');
-    }
-    const moduleService = await getModuleService();
-    let resolvedTarget = target;
-    if (!resolvedTarget && targetName) {
-        const targets = await moduleService.listTargets();
-        resolvedTarget = targets.find((t) => t.name === targetName);
-        if (!resolvedTarget) {
-            res.status(404).json({
-                success: false,
-                error: { code: 'NOT_FOUND', message: `Target not found: ${targetName}` },
-            });
-            return;
-        }
-    }
-    const files = await moduleService.getTargetFiles(resolvedTarget);
-    res.json({
-        success: true,
-        data: {
-            target: resolvedTarget.name || targetName,
-            files,
-            total: files.length,
-        },
-    });
-});
-/**
- * POST /api/v1/spm/scan
- * AI 扫描 Target，发现候选项
- */
-router.post('/scan', async (req, res) => {
-    const { target, targetName, options = {} } = req.body;
-    if (!target && !targetName) {
-        throw new ValidationError('target object or targetName is required');
-    }
-    const moduleService = await getModuleService();
-    let resolvedTarget = target;
-    if (!resolvedTarget && targetName) {
-        const targets = await moduleService.listTargets();
-        resolvedTarget = targets.find((t) => t.name === targetName);
-        if (!resolvedTarget) {
-            res.status(404).json({
-                success: false,
-                error: { code: 'NOT_FOUND', message: `Target not found: ${targetName}` },
-            });
-            return;
-        }
-    }
-    logger.info('Module scan started via /spm/', { target: resolvedTarget.name });
-    const result = await moduleService.scanTarget(resolvedTarget, options);
-    res.json({
-        success: true,
-        data: result,
-    });
-});
-// ── 流式 Target 扫描（SSE Session + EventSource 架构） ─────────
-/**
- * POST /api/v1/spm/scan/stream
- * 创建流式扫描会话，后台异步执行 AI 扫描
- *
- * 协议事件（通过 SSE session 缓冲 + EventSource 交付）:
- *   scan:started       — 扫描启动
- *   scan:files-loaded   — 文件列表就绪，含 files[] + count
- *   scan:reading        — 读取文件内容中
- *   scan:ai-extracting  — AI 提取开始（耗时阶段）
- *   scan:enriching      — 后处理阶段
- *   scan:completed      — 最终结果 {recipes, scannedFiles, recipeCount, fileCount}
- *   scan:error          — 发生错误
- *   stream:done         — 会话结束标记
- */
-router.post('/scan/stream', async (req, res) => {
-    const { target, targetName, options = {} } = req.body;
-    if (!target && !targetName) {
-        throw new ValidationError('target object or targetName is required');
-    }
-    const moduleService = await getModuleService();
-    let resolvedTarget = target;
-    if (!resolvedTarget && targetName) {
-        const targets = await moduleService.listTargets();
-        resolvedTarget = targets.find((t) => t.name === targetName);
-        if (!resolvedTarget) {
-            res.status(404).json({
-                success: false,
-                error: { code: 'NOT_FOUND', message: `Target not found: ${targetName}` },
-            });
-            return;
-        }
-    }
-    // 创建 SSE session
-    const session = createStreamSession('scan');
-    const tName = resolvedTarget.name || targetName;
-    // 立即返回 sessionId
-    res.json({ sessionId: session.sessionId });
-    // 异步执行扫描，通过 session 推送进度事件
-    setImmediate(async () => {
-        try {
-            logger.info('Module stream scan started via /spm/', {
-                target: tName,
-                sessionId: session.sessionId,
-            });
-            const result = await moduleService.scanTarget(resolvedTarget, {
-                ...options,
-                onProgress(event) {
-                    session.send(event);
-                },
-            });
-            // 发送最终结果
-            session.send({
-                type: 'scan:result',
-                recipes: result.recipes || [],
-                scannedFiles: result.scannedFiles || [],
-                message: result.message || '',
-                recipeCount: (result.recipes || []).length,
-                fileCount: (result.scannedFiles || []).length,
-            });
-            session.end();
-        }
-        catch (err) {
-            const errMsg = err instanceof Error ? err.message : String(err);
-            logger.error('Module stream scan failed via /spm/', { target: tName, error: errMsg });
-            session.error(errMsg, 'SCAN_ERROR');
-        }
-    });
-});
-/**
- * GET /api/v1/spm/scan/events/:sessionId
- * EventSource SSE 端点 — 消费扫描进度事件
- *
- * 复用 chat/events 相同的 SSE 交付模式：回放缓冲 → 订阅实时 → 心跳保活
- */
-router.get('/scan/events/:sessionId', (req, res) => {
-    const session = getStreamSession(req.params.sessionId);
-    if (!session) {
-        res.status(404).json({ success: false, error: 'Session not found or expired' });
-        return;
-    }
-    // ─── SSE Headers ───
-    res.setHeader('Content-Type', 'text/event-stream');
-    res.setHeader('Cache-Control', 'no-cache');
-    res.setHeader('Connection', 'keep-alive');
-    res.setHeader('X-Accel-Buffering', 'no');
-    res.flushHeaders();
-    if (res.socket) {
-        res.socket.setNoDelay(true);
-        res.socket.setTimeout(0);
-    }
-    function writeEvent(event) {
-        if (res.writableEnded) {
-            return;
-        }
-        res.write(`data: ${JSON.stringify(event)}\n\n`);
-    }
-    // 1) 回放缓冲区
-    let isDone = false;
-    for (const event of session.buffer) {
-        writeEvent(event);
-        if (event.type === 'stream:done' || event.type === 'stream:error') {
-            isDone = true;
-        }
-    }
-    if (isDone || session.completed) {
-        res.end();
-        return;
-    }
-    // 2) 订阅实时事件
-    const unsubscribe = session.on((event) => {
-        writeEvent(event);
-        if (event.type === 'stream:done' || event.type === 'stream:error') {
-            unsubscribe();
-            clearInterval(heartbeat);
-            res.end();
-        }
-    });
-    // 心跳保活 (每 15 秒)
-    const heartbeat = setInterval(() => {
-        if (res.writableEnded) {
-            clearInterval(heartbeat);
-            return;
-        }
-        res.write(`: ping ${Date.now()}\n\n`);
-    }, 15_000);
-    // 客户端断开连接时清理
-    res.on('close', () => {
-        unsubscribe();
-        clearInterval(heartbeat);
-    });
-});
-/**
- * POST /api/v1/spm/scan-project
- * 全项目扫描：AI 提取候选 + Guard 审计
- */
-router.post('/scan-project', async (req, res) => {
-    const { options = {} } = req.body;
-    const moduleService = await getModuleService();
-    logger.info('Full project scan started via /spm/');
-    const result = await moduleService.scanProject(options);
-    res.json({
-        success: true,
-        data: result,
-    });
-});
-/**
- * POST /api/v1/spm/bootstrap
- * 冷启动：快速骨架 + 异步逐维度填充（v5）
- *
- * 执行策略：
- *   ① 同步阶段: Phase 1-4（文件收集 + AST + SPM + Guard + 骨架响应）→ 立即返回
- *   ② 异步阶段: Phase 5/5.5（逐维度提取 + Candidate/Skill 创建）→ 后台逐一执行
- *   ③ 进度推送: 通过 Socket.io 实时推送每个维度的完成状态
- *
- * 前端立即获得骨架 + 任务清单，每个维度完成后通过 Socket.io 推送更新。
- */
-router.post('/bootstrap', async (req, res) => {
-    const { maxFiles, skipGuard, contentMaxLines } = req.body || {};
-    const container = getServiceContainer();
-    const agentFactory = container.get('agentFactory');
-    logger.info('Bootstrap cold start initiated (v5: async fill mode)');
-    // ── 同步阶段: 快速执行 Phase 1-4 → 返回骨架 ──
-    const bootstrapResult = await agentFactory.bootstrapKnowledge({
-        maxFiles: maxFiles || 500,
-        skipGuard: skipGuard || false,
-        contentMaxLines: contentMaxLines || 120,
-        loadSkills: true,
-    });
-    // 立即返回骨架结果给前端
-    res.json({
-        success: true,
-        data: {
-            ...bootstrapResult,
-            asyncFill: true, // 告知前端：内容正在异步填充中
-        },
-    });
-    // 注意：Phase 5/5.5 异步填充已在 bootstrapKnowledge() 内部通过 setImmediate 启动
-    // 进度通过 BootstrapTaskManager → Socket.io 推送到前端
-});
-/**
- * GET /api/v1/spm/bootstrap/status
- * 查询当前 bootstrap 异步填充进度
- *
- * 返回当前 session 的任务状态列表，供前端轮询（Socket.io 不可用时的 fallback）
- */
-router.get('/bootstrap/status', async (req, res) => {
-    const container = getServiceContainer();
-    // 从容器获取 BootstrapTaskManager（正式 DI 注册）
-    let taskManager = null;
-    try {
-        taskManager = container.get('bootstrapTaskManager');
-    }
-    catch {
-        /* not registered */
-    }
-    if (!taskManager) {
-        res.json({
-            success: true,
-            data: { status: 'idle', message: 'No bootstrap task manager initialized' },
-        });
-        return;
-    }
-    res.json({
-        success: true,
-        data: taskManager.getSessionStatus(),
-    });
-});
-export default router;

package/dist/lib/platform/ios/snippet/PlaceholderConverter.d.ts

@@ -1,21 +0,0 @@
-/**
- * PlaceholderConverter — Xcode <#…#> ↔ VSCode ${N:…} 双向占位符转换
- *
- * 转换规则:
- *   Xcode → VSCode:
- *     <#name#>            → ${1:name}     (序号自动递增)
- *     <#T##Type#>         → ${1:Type}     (取最后一段)
- *     <#T##Label##Type#>  → ${1:Label}    (取 Label 段)
- *
- *   VSCode → Xcode:
- *     ${1:name}           → <#name#>
- *     ${1}                → <#value#>
- *     $1                  → <#value#>
- *     $0                  → (移除，Xcode 无终止光标)
- */
-export declare class PlaceholderConverter {
-    /** Xcode → VSCode 占位符转换 */
-    static xcodeToVSCode(code: string): string;
-    /** VSCode → Xcode 占位符转换 */
-    static vscodeToXcode(code: string): string;
-}

package/dist/lib/platform/ios/snippet/PlaceholderConverter.js

@@ -1,48 +0,0 @@
-/**
- * PlaceholderConverter — Xcode <#…#> ↔ VSCode ${N:…} 双向占位符转换
- *
- * 转换规则:
- *   Xcode → VSCode:
- *     <#name#>            → ${1:name}     (序号自动递增)
- *     <#T##Type#>         → ${1:Type}     (取最后一段)
- *     <#T##Label##Type#>  → ${1:Label}    (取 Label 段)
- *
- *   VSCode → Xcode:
- *     ${1:name}           → <#name#>
- *     ${1}                → <#value#>
- *     $1                  → <#value#>
- *     $0                  → (移除，Xcode 无终止光标)
- */
-export class PlaceholderConverter {
-    /** Xcode → VSCode 占位符转换 */
-    static xcodeToVSCode(code) {
-        if (!code) {
-            return '';
-        }
-        let index = 0;
-        return code.replace(/<#(.*?)#>/g, (_match, inner) => {
-            index++;
-            // <#T##Label##Type#> → Label (parts[1])
-            // <#T##Type#>        → Type  (parts[1])
-            // <#name#>           → name  (inner)
-            const parts = inner.split('##');
-            const label = parts.length >= 2 ? parts[1] : inner;
-            return `\${${index}:${label}}`;
-        });
-    }
-    /** VSCode → Xcode 占位符转换 */
-    static vscodeToXcode(code) {
-        if (!code) {
-            return '';
-        }
-        return (code
-            // ${1:name} → <#name#>
-            .replace(/\$\{(\d+):([^}]*)}/g, (_m, _n, label) => `<#${label}#>`)
-            // ${1} → <#value#>
-            .replace(/\$\{(\d+)}/g, '<#value#>')
-            // $0 → remove (Xcode has no final cursor)
-            .replace(/\$0/g, '')
-            // $1..$9 → <#value#>
-            .replace(/\$([1-9]\d*)/g, '<#value#>'));
-    }
-}

package/dist/lib/platform/ios/snippet/XcodeCodec.d.ts

@@ -1,23 +0,0 @@
-/**
- * XcodeCodec — Xcode .codesnippet (plist XML) 生成器
- *
- * 从原 SnippetFactory 提取的 Xcode 专用逻辑:
- *   - XML plist 模板
- *   - Xcode 语言 ID 映射
- *   - XML 转义
- */
-import { SnippetCodec, type SnippetSpec } from '#service/snippet/codecs/SnippetCodec.js';
-export declare class XcodeCodec extends SnippetCodec {
-    get id(): string;
-    get fileExtension(): string;
-    /** SnippetSpec → plist XML 字符串 */
-    generate(spec: SnippetSpec): string;
-    /** Xcode: 每个 snippet 一个文件 → 返回 Array<{ filename, content }> */
-    generateBundle(specs: SnippetSpec[]): Array<{
-        filename: string;
-        content: string;
-    }>;
-    /** Xcode snippets 全局目录 (macOS only) */
-    getInstallDir(_projectRoot: string | undefined): string;
-    mapLanguage(lang: string | undefined): string;
-}

package/dist/lib/platform/ios/snippet/XcodeCodec.js

@@ -1,96 +0,0 @@
-/**
- * XcodeCodec — Xcode .codesnippet (plist XML) 生成器
- *
- * 从原 SnippetFactory 提取的 Xcode 专用逻辑:
- *   - XML plist 模板
- *   - Xcode 语言 ID 映射
- *   - XML 转义
- */
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-import { SnippetCodec } from '#service/snippet/codecs/SnippetCodec.js';
-const XCODE_LANGUAGE_MAP = {
-    swift: 'Xcode.SourceCodeLanguage.Swift',
-    'objective-c': 'Xcode.SourceCodeLanguage.Objective-C',
-    objc: 'Xcode.SourceCodeLanguage.Objective-C',
-    c: 'Xcode.SourceCodeLanguage.C',
-    'c++': 'Xcode.SourceCodeLanguage.C-Plus-Plus',
-    javascript: 'Xcode.SourceCodeLanguage.JavaScript',
-};
-const PLIST_TEMPLATE = `<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
-\t<key>IDECodeSnippetCompletionPrefix</key>
-\t<string>{completion}</string>
-\t<key>IDECodeSnippetCompletionScopes</key>
-\t<array>
-\t\t<string>All</string>
-\t</array>
-\t<key>IDECodeSnippetContents</key>
-\t<string>{content}</string>
-\t<key>IDECodeSnippetIdentifier</key>
-\t<string>{identifier}</string>
-\t<key>IDECodeSnippetLanguage</key>
-\t<string>{language}</string>
-\t<key>IDECodeSnippetSummary</key>
-\t<string>{summary}</string>
-\t<key>IDECodeSnippetTitle</key>
-\t<string>{title}</string>
-\t<key>IDECodeSnippetUserSnippet</key>
-\t<true/>
-\t<key>IDECodeSnippetVersion</key>
-\t<integer>2</integer>
-</dict>
-</plist>`;
-export class XcodeCodec extends SnippetCodec {
-    get id() {
-        return 'xcode';
-    }
-    get fileExtension() {
-        return '.codesnippet';
-    }
-    /** SnippetSpec → plist XML 字符串 */
-    generate(spec) {
-        if (!spec?.identifier || !spec?.code) {
-            throw new Error('Snippet spec must have identifier and code');
-        }
-        const content = Array.isArray(spec.code) ? spec.code.join('\n') : spec.code;
-        const languageKey = this.mapLanguage(spec.language);
-        let xml = PLIST_TEMPLATE;
-        xml = xml.replace('{identifier}', escapeXml(spec.identifier));
-        xml = xml.replace('{title}', escapeXml(spec.title || spec.identifier));
-        xml = xml.replace('{completion}', escapeXml(spec.completion || spec.identifier));
-        xml = xml.replace('{summary}', escapeXml(spec.summary || ''));
-        xml = xml.replace('{content}', escapeXml(content));
-        xml = xml.replace('{language}', languageKey);
-        return xml;
-    }
-    /** Xcode: 每个 snippet 一个文件 → 返回 Array<{ filename, content }> */
-    generateBundle(specs) {
-        return specs.map((spec) => ({
-            filename: `${spec.identifier}${this.fileExtension}`,
-            content: this.generate(spec),
-        }));
-    }
-    /** Xcode snippets 全局目录 (macOS only) */
-    getInstallDir(_projectRoot) {
-        return join(homedir(), 'Library/Developer/Xcode/UserData/CodeSnippets');
-    }
-    mapLanguage(lang) {
-        return (XCODE_LANGUAGE_MAP[lang?.toLowerCase() ?? ''] ||
-            XCODE_LANGUAGE_MAP.swift);
-    }
-}
-/** XML 特殊字符转义 */
-function escapeXml(str) {
-    if (!str) {
-        return '';
-    }
-    return String(str)
-        .replace(/&/g, '&amp;')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;')
-        .replace(/'/g, '&apos;');
-}

package/dist/lib/platform/ios/spm/DependencyGraph.d.ts

@@ -1,56 +0,0 @@
-/**
- * DependencyGraph — SPM 依赖图构建与分析
- * 合并 V1 DepGraphService + DepGraphAnalyzer
- * 构建 target 级依赖 DAG，支持层级计算、拓扑排序、可达性检查
- */
-export declare class DependencyGraph {
-    #private;
-    constructor();
-    /**
-     * 从 PackageSwiftParser 的解析结果构建图
-     * @param parsed
-     */
-    buildFromParsed(parsed: {
-        targets: {
-            name: string;
-            dependencies: string[];
-        }[];
-    }): void;
-    /** 添加节点 */
-    addNode(name: string): void;
-    /** 添加边: from 依赖 to */
-    addEdge(from: string, to: string): void;
-    /** BFS 可达性检查 */
-    isReachable(from: string, to: string): boolean;
-    /**
-     * 检测循环依赖
-     * @returns 循环路径列表
-     */
-    detectCycles(): string[][];
-    /**
-     * 拓扑排序 (Kahn's algorithm)
-     * @returns 若有环则返回部分结果
-     */
-    topologicalSort(): string[];
-    /**
-     * 层级计算: L0 = 无依赖的节点, L1 = 只依赖 L0, etc.
-     * @returns node → level
-     */
-    computeLevels(): Map<any, any>;
-    /** 获取节点的直接依赖 */
-    getDependencies(node: string): string[];
-    /** 获取节点的直接依赖者 (谁依赖了这个节点) */
-    getDependents(node: string): string[];
-    /** 获取所有节点 */
-    getNodes(): string[];
-    edgeCount(): number;
-    clear(): void;
-    /** 导出为 JSON (可视化用) */
-    toJSON(): {
-        nodes: string[];
-        edges: {
-            from: string;
-            to: string;
-        }[];
-    };
-}