autosnippet 3.3.6 → 3.3.7

package/dist/lib/core/discovery/parsers/StarlarkParser.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @module StarlarkParser
+ * @description Starlark (Python 子集) 轻量解析器 — 从 BUILD / BUILD.bazel / BUCK 文件提取构建目标信息
+ *
+ * 支持解析：
+ *  - load() 语句 → 推断语言
+ *  - 目标声明 (swift_library, cc_binary, java_library 等)
+ *  - name / deps / srcs / visibility 字段
+ *
+ * 设计策略: 正则 + 逐行状态机（不做宏展开）
+ */
+export interface StarlarkTarget {
+    rule: string;
+    name: string;
+    srcs: string[];
+    deps: string[];
+    visibility: string[];
+    testonly?: boolean;
+}
+export interface LoadStatement {
+    repository: string;
+    path: string;
+    symbols: string[];
+}
+export interface ParsedBuildFile {
+    targets: StarlarkTarget[];
+    loads: LoadStatement[];
+}
+export declare const RULE_TO_LANGUAGE: Record<string, string>;
+/**
+ * 解析单个 BUILD/BUILD.bazel/BUCK 文件内容
+ */
+export declare function parseStarlarkBuildFile(content: string): ParsedBuildFile;

package/dist/lib/core/discovery/parsers/StarlarkParser.js

@@ -0,0 +1,229 @@
+/**
+ * @module StarlarkParser
+ * @description Starlark (Python 子集) 轻量解析器 — 从 BUILD / BUILD.bazel / BUCK 文件提取构建目标信息
+ *
+ * 支持解析：
+ *  - load() 语句 → 推断语言
+ *  - 目标声明 (swift_library, cc_binary, java_library 等)
+ *  - name / deps / srcs / visibility 字段
+ *
+ * 设计策略: 正则 + 逐行状态机（不做宏展开）
+ */
+// ── 规则名 → 语言映射 ────────────────────────────────
+export const RULE_TO_LANGUAGE = {
+    // Bazel
+    swift_library: 'swift',
+    swift_binary: 'swift',
+    swift_test: 'swift',
+    cc_library: 'cpp',
+    cc_binary: 'cpp',
+    cc_test: 'cpp',
+    java_library: 'java',
+    java_binary: 'java',
+    java_test: 'java',
+    kt_jvm_library: 'kotlin',
+    kt_jvm_binary: 'kotlin',
+    py_library: 'python',
+    py_binary: 'python',
+    py_test: 'python',
+    go_library: 'go',
+    go_binary: 'go',
+    go_test: 'go',
+    rust_library: 'rust',
+    rust_binary: 'rust',
+    rust_test: 'rust',
+    ts_project: 'typescript',
+    proto_library: 'protobuf',
+    // Buck2
+    cxx_library: 'cpp',
+    cxx_binary: 'cpp',
+    cxx_test: 'cpp',
+    android_library: 'kotlin',
+    android_binary: 'kotlin',
+    apple_library: 'swift',
+    apple_binary: 'swift',
+    python_library: 'python',
+    python_binary: 'python',
+    // Pants
+    python_source: 'python',
+    python_sources: 'python',
+    docker_image: 'docker',
+};
+// ── 正则模式 ────────────────────────────────────────
+const LOAD_RE = /^load\(\s*"([^"]+)"\s*,\s*((?:"[^"]+"(?:\s*,\s*)?)+)\s*\)/;
+const RULE_CALL_RE = /^(\w+)\(\s*$/;
+const NAME_RE = /name\s*=\s*"([^"]+)"/;
+const TESTONLY_RE = /testonly\s*=\s*(True|1)/;
+const STRING_LIST_RE = (field) => new RegExp(`${field}\\s*=\\s*(?:glob\\(\\s*)?\\[([^\\]]*)\\]`, 's');
+const DEP_LABEL_RE = /"((?:\/\/[^"]*|:[^"]*))"/g;
+const GLOB_RE = /glob\(\s*\[([^\]]*)\]\s*\)/;
+// ── 公开 API ────────────────────────────────────────
+/**
+ * 解析单个 BUILD/BUILD.bazel/BUCK 文件内容
+ */
+export function parseStarlarkBuildFile(content) {
+    const result = { targets: [], loads: [] };
+    const lines = content.split('\n');
+    // Pass 1: 提取 load 语句
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith('#')) {
+            continue;
+        }
+        const loadMatch = trimmed.match(LOAD_RE);
+        if (loadMatch) {
+            const fullLabel = loadMatch[1];
+            const symbolsPart = loadMatch[2];
+            // 解析 repository 和 path
+            let repository = '';
+            let path = fullLabel;
+            if (fullLabel.startsWith('@')) {
+                const slashIdx = fullLabel.indexOf('//');
+                if (slashIdx !== -1) {
+                    repository = fullLabel.substring(0, slashIdx);
+                    path = fullLabel.substring(slashIdx);
+                }
+            }
+            const symbols = [];
+            const symRe = /"([^"]+)"/g;
+            let symMatch;
+            while ((symMatch = symRe.exec(symbolsPart)) !== null) {
+                symbols.push(symMatch[1]);
+            }
+            result.loads.push({ repository, path, symbols });
+        }
+    }
+    // Pass 2: 提取目标声明（逐行状态机）
+    let i = 0;
+    while (i < lines.length) {
+        const trimmed = lines[i].trim();
+        // 跳过注释和空行
+        if (trimmed.startsWith('#') || trimmed === '') {
+            i++;
+            continue;
+        }
+        // 检测规则调用开始: rule_name(
+        const ruleMatch = trimmed.match(RULE_CALL_RE);
+        if (ruleMatch) {
+            const rule = ruleMatch[1];
+            // 收集整个调用块直到匹配的 )
+            const blockLines = [trimmed];
+            let depth = 1;
+            let j = i + 1;
+            while (j < lines.length && depth > 0) {
+                const bLine = lines[j];
+                for (const ch of bLine) {
+                    if (ch === '(') {
+                        depth++;
+                    }
+                    if (ch === ')') {
+                        depth--;
+                    }
+                }
+                blockLines.push(bLine);
+                j++;
+            }
+            const block = blockLines.join('\n');
+            const target = parseTargetBlock(rule, block);
+            if (target) {
+                result.targets.push(target);
+            }
+            i = j;
+            continue;
+        }
+        // 也检测单行调用: rule_name(name = "...")
+        const inlineMatch = trimmed.match(/^(\w+)\(/);
+        if (inlineMatch && RULE_TO_LANGUAGE[inlineMatch[1]]) {
+            // 同样收集到闭合 )
+            const rule = inlineMatch[1];
+            const blockLines = [trimmed];
+            let depth = 0;
+            for (const ch of trimmed) {
+                if (ch === '(') {
+                    depth++;
+                }
+                if (ch === ')') {
+                    depth--;
+                }
+            }
+            let j = i + 1;
+            while (j < lines.length && depth > 0) {
+                const bLine = lines[j];
+                for (const ch of bLine) {
+                    if (ch === '(') {
+                        depth++;
+                    }
+                    if (ch === ')') {
+                        depth--;
+                    }
+                }
+                blockLines.push(bLine);
+                j++;
+            }
+            const block = blockLines.join('\n');
+            const target = parseTargetBlock(rule, block);
+            if (target) {
+                result.targets.push(target);
+            }
+            i = j;
+            continue;
+        }
+        i++;
+    }
+    return result;
+}
+// ── 内部解析函数 ────────────────────────────────────
+function parseTargetBlock(rule, block) {
+    const nameMatch = block.match(NAME_RE);
+    if (!nameMatch) {
+        return null;
+    }
+    return {
+        rule,
+        name: nameMatch[1],
+        srcs: extractStringList(block, 'srcs'),
+        deps: extractDepLabels(block),
+        visibility: extractStringList(block, 'visibility'),
+        testonly: TESTONLY_RE.test(block) ? true : undefined,
+    };
+}
+function extractStringList(block, field) {
+    const listMatch = block.match(STRING_LIST_RE(field));
+    if (!listMatch) {
+        return [];
+    }
+    let inner = listMatch[1];
+    // 处理 glob() 模式
+    const globMatch = inner.match(GLOB_RE);
+    if (globMatch) {
+        inner = globMatch[1];
+    }
+    const items = [];
+    const strRe = /"([^"]+)"/g;
+    let m;
+    while ((m = strRe.exec(inner)) !== null) {
+        items.push(m[1]);
+    }
+    return items;
+}
+function extractDepLabels(block) {
+    const depsMatch = block.match(STRING_LIST_RE('deps'));
+    if (!depsMatch) {
+        return [];
+    }
+    const inner = depsMatch[1];
+    const deps = [];
+    const re = new RegExp(DEP_LABEL_RE.source, 'g');
+    let m;
+    while ((m = re.exec(inner)) !== null) {
+        deps.push(m[1]);
+    }
+    // 也捕获非标签格式的字符串依赖
+    const strRe = /"([^"]+)"/g;
+    while ((m = strRe.exec(inner)) !== null) {
+        if (!m[1].startsWith('//') && !m[1].startsWith(':') && !deps.includes(m[1])) {
+            deps.push(m[1]);
+        }
+    }
+    return deps;
+}

package/dist/lib/core/discovery/parsers/YamlConfigParser.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @module YamlConfigParser
+ * @description YAML 配置解析器 — 从 XcodeGen project.yml 中提取项目结构信息
+ *
+ * 支持解析：
+ *  - targets（构建目标）及其依赖关系
+ *  - settings（项目级/目标级构建设置）
+ *  - schemes（构建方案）
+ *  - sources（源文件路径）
+ *
+ * 使用 js-yaml 进行安全解析（禁用危险的 YAML 特性）。
+ */
+import type { ParsedModuleSpec, ParsedProjectConfig } from './RubyDslParser.js';
+/**
+ * 解析 XcodeGen project.yml 内容
+ * 返回与 RubyDslParser 兼容的 ParsedProjectConfig
+ */
+export declare function parseXcodeGenProject(content: string): ParsedProjectConfig;
+/**
+ * 解析单个 target 为 ParsedModuleSpec 格式
+ */
+export declare function parseXcodeGenTarget(targetName: string, content: string): ParsedModuleSpec | null;
+/**
+ * 提取所有 target 的依赖图
+ * 返回 [from, to][] 形式的有向边列表
+ */
+export declare function extractXcodeGenDependencyEdges(content: string): Array<[string, string]>;
+export interface ParsedMelosProject {
+    name: string;
+    packageGlobs: string[];
+    scripts: string[];
+}
+/**
+ * 解析 melos.yaml 内容
+ * 提取项目名、包路径 glob 模式、scripts 列表
+ */
+export declare function parseMelosProject(content: string): ParsedMelosProject;

package/dist/lib/core/discovery/parsers/YamlConfigParser.js

@@ -0,0 +1,212 @@
+/**
+ * @module YamlConfigParser
+ * @description YAML 配置解析器 — 从 XcodeGen project.yml 中提取项目结构信息
+ *
+ * 支持解析：
+ *  - targets（构建目标）及其依赖关系
+ *  - settings（项目级/目标级构建设置）
+ *  - schemes（构建方案）
+ *  - sources（源文件路径）
+ *
+ * 使用 js-yaml 进行安全解析（禁用危险的 YAML 特性）。
+ */
+import yaml from 'js-yaml';
+// ── 目标类型 → 层级推断 ────────────────────────────────
+const TARGET_TYPE_LAYER = {
+    application: 'App',
+    'app-extension': 'Extension',
+    framework: 'Framework',
+    'static-library': 'Library',
+    'dynamic-library': 'Library',
+    bundle: 'Resource',
+    'unit-test': 'Test',
+    'ui-test': 'Test',
+    tool: 'Tool',
+};
+// ── 公开 API ────────────────────────────────────────
+/**
+ * 解析 XcodeGen project.yml 内容
+ * 返回与 RubyDslParser 兼容的 ParsedProjectConfig
+ */
+export function parseXcodeGenProject(content) {
+    let doc;
+    try {
+        doc = yaml.load(content, { schema: yaml.CORE_SCHEMA });
+    }
+    catch {
+        return { layers: [], globalDependencies: [] };
+    }
+    if (!doc || typeof doc !== 'object') {
+        return { layers: [], globalDependencies: [] };
+    }
+    const result = {
+        layers: [],
+        globalDependencies: [],
+    };
+    // 提取宿主应用
+    if (doc.name) {
+        result.hostApp = { name: doc.name, version: '0.0.0' };
+    }
+    if (!doc.targets) {
+        return result;
+    }
+    // 将 targets 按类型分层
+    const layerMap = new Map();
+    for (const [targetName, target] of Object.entries(doc.targets)) {
+        const targetType = target.type ?? 'framework';
+        const layerName = TARGET_TYPE_LAYER[targetType] ?? 'Other';
+        const isLocal = !isExternalTarget(targetName, doc);
+        const mod = {
+            name: targetName,
+            version: '0.0.0',
+            isLocal,
+            localPath: extractSourcePath(target),
+            group: layerName,
+        };
+        if (!layerMap.has(layerName)) {
+            layerMap.set(layerName, []);
+        }
+        layerMap.get(layerName)?.push(mod);
+    }
+    // 转为 ParsedLayer[]
+    let order = 0;
+    for (const [name, modules] of layerMap.entries()) {
+        result.layers.push({
+            name,
+            order: order++,
+            accessibleLayers: [],
+            modules,
+        });
+    }
+    // 提取 SPM packages → globalDependencies
+    if (doc.packages) {
+        for (const [pkgName, pkg] of Object.entries(doc.packages)) {
+            result.globalDependencies.push({
+                name: pkgName,
+                version: pkg.from ?? pkg.version ?? pkg.branch ?? '0.0.0',
+                isLocal: !!pkg.path,
+                localPath: pkg.path,
+            });
+        }
+    }
+    return result;
+}
+/**
+ * 解析单个 target 为 ParsedModuleSpec 格式
+ */
+export function parseXcodeGenTarget(targetName, content) {
+    let doc;
+    try {
+        doc = yaml.load(content, { schema: yaml.CORE_SCHEMA });
+    }
+    catch {
+        return null;
+    }
+    if (!doc?.targets?.[targetName]) {
+        return null;
+    }
+    const target = doc.targets[targetName];
+    return {
+        name: targetName,
+        version: '0.0.0',
+        sources: extractSourcePath(target) ?? targetName,
+        dependencies: extractTargetDependencies(target),
+        publicHeaders: [],
+        deploymentTarget: extractDeploymentTarget(target),
+    };
+}
+/**
+ * 提取所有 target 的依赖图
+ * 返回 [from, to][] 形式的有向边列表
+ */
+export function extractXcodeGenDependencyEdges(content) {
+    let doc;
+    try {
+        doc = yaml.load(content, { schema: yaml.CORE_SCHEMA });
+    }
+    catch {
+        return [];
+    }
+    if (!doc?.targets) {
+        return [];
+    }
+    const edges = [];
+    for (const [targetName, target] of Object.entries(doc.targets)) {
+        if (!target.dependencies) {
+            continue;
+        }
+        for (const dep of target.dependencies) {
+            const depName = dep.target ?? dep.framework ?? dep.package ?? dep.carthage;
+            if (depName) {
+                edges.push([targetName, depName]);
+            }
+        }
+    }
+    return edges;
+}
+// ── 内部帮助函数 ────────────────────────────────────
+function extractSourcePath(target) {
+    if (!target.sources || target.sources.length === 0) {
+        return undefined;
+    }
+    const first = target.sources[0];
+    if (typeof first === 'string') {
+        return first;
+    }
+    return first.path;
+}
+function extractTargetDependencies(target) {
+    if (!target.dependencies) {
+        return [];
+    }
+    return target.dependencies
+        .map((dep) => dep.target ?? dep.framework ?? dep.package ?? dep.carthage)
+        .filter((name) => !!name);
+}
+function extractDeploymentTarget(target) {
+    if (!target.deploymentTarget) {
+        return undefined;
+    }
+    if (typeof target.deploymentTarget === 'string') {
+        return target.deploymentTarget;
+    }
+    // Object form: { iOS: "15.0", macOS: "12.0" }
+    const values = Object.values(target.deploymentTarget);
+    return values[0];
+}
+function isExternalTarget(targetName, doc) {
+    // SPM packages referenced as targets are external
+    if (doc.packages?.[targetName]) {
+        return true;
+    }
+    // Targets defined in the project are local
+    return false;
+}
+/**
+ * 解析 melos.yaml 内容
+ * 提取项目名、包路径 glob 模式、scripts 列表
+ */
+export function parseMelosProject(content) {
+    const result = {
+        name: '',
+        packageGlobs: [],
+        scripts: [],
+    };
+    try {
+        const doc = yaml.load(content, { schema: yaml.CORE_SCHEMA });
+        if (!doc) {
+            return result;
+        }
+        result.name = doc.name ?? '';
+        if (Array.isArray(doc.packages)) {
+            result.packageGlobs = doc.packages.filter((p) => typeof p === 'string');
+        }
+        if (doc.scripts && typeof doc.scripts === 'object') {
+            result.scripts = Object.keys(doc.scripts);
+        }
+    }
+    catch {
+        // YAML 解析失败时返回空结果
+    }
+    return result;
+}

package/dist/lib/domain/knowledge/KnowledgeEntry.d.ts

@@ -61,6 +61,7 @@ export declare class KnowledgeEntry {
         from: string;
         to: string;
         at: number;
+        by?: string;
     }>;
     autoApprovable: boolean;
     stagingDeadline: number | null;
@@ -152,6 +153,11 @@ export declare class KnowledgeEntry {
         success: boolean;
         error?: string;
     };
+    /**
+     * 将最后一条 lifecycleHistory 条目标记操作人。
+     * 由 KnowledgeService._lifecycleTransition() 在 entity method 执行后调用。
+     */
+    stampLastTransition(by: string): void;
     /** 是否处于候选阶段 */
     isCandidate(): boolean;
     /** 是否可被 Guard/Search/Export 消费 */
@@ -194,7 +200,7 @@ export declare class KnowledgeEntry {
     /** JSON → Domain (camelCase 直入) */
     static fromJSON(data: unknown): KnowledgeEntry;
     /** @returns } */
-    _transition(to: string): {
+    _transition(to: string, by?: string): {
         success: boolean;
         error?: string;
     };

package/dist/lib/domain/knowledge/KnowledgeEntry.js

@@ -173,6 +173,16 @@ export class KnowledgeEntry {
         }
         return result;
     }
+    /**
+     * 将最后一条 lifecycleHistory 条目标记操作人。
+     * 由 KnowledgeService._lifecycleTransition() 在 entity method 执行后调用。
+     */
+    stampLastTransition(by) {
+        const last = this.lifecycleHistory[this.lifecycleHistory.length - 1];
+        if (last) {
+            last.by = by;
+        }
+    }
     /* ═══ 谓词 ═══════════════════════════════════════════ */
     /** 是否处于候选阶段 */
     isCandidate() {
@@ -289,18 +299,22 @@ export class KnowledgeEntry {
     }
     /* ═══ 私有 ═══════════════════════════════════════════ */
     /** @returns } */
-    _transition(to) {
+    _transition(to, by) {
         if (!isValidTransition(this.lifecycle, to)) {
             return {
                 success: false,
                 error: `Invalid lifecycle transition: ${this.lifecycle} → ${to}`,
             };
         }
-        this.lifecycleHistory.push({
+        const entry = {
             from: this.lifecycle,
             to,
             at: this._now(),
-        });
+        };
+        if (by) {
+            entry.by = by;
+        }
+        this.lifecycleHistory.push(entry);
         this.lifecycle = to;
         this.updatedAt = this._now();
         return { success: true };

package/dist/lib/external/ai/AiProvider.d.ts

@@ -148,6 +148,13 @@ export declare class AiProvider {
     name: string;
     timeout: number;
     _fallbackFrom?: string;
+    /**
+     * Token 用量回调 — 每次 API 调用后触发（包括 chat / chatWithStructuredOutput / chatWithTools）
+     * 由外部（如 DI 容器）注入以实现全局 token 计量。
+     */
+    _onTokenUsage: ((usage: TokenUsage & {
+        source?: string;
+    }) => void) | null;
     constructor(config?: AiProviderConfig);
     _acquireRequestSlot(): Promise<void>;
     _releaseRequestSlot(): void;
@@ -158,6 +165,11 @@ export declare class AiProvider {
      * @param context {history: [], temperature, maxTokens}
      */
     chat(prompt: string, context?: ChatContext): Promise<string>;
+    /**
+     * 从 API 原始响应中提取 token 用量并触发回调。
+     * 子类在 chat() / chatWithStructuredOutput() 中调用。
+     */
+    _emitTokenUsage(usage: TokenUsage | null | undefined, source?: string): void;
     /** 摘要 - 对代码/文档生成结构化摘要 */
     summarize(code: string): Promise<unknown>;
     /** 向量嵌入 - 返回浮点数组 */

package/dist/lib/external/ai/AiProvider.js

@@ -21,6 +21,11 @@ export class AiProvider {
     name;
     timeout;
     _fallbackFrom;
+    /**
+     * Token 用量回调 — 每次 API 调用后触发（包括 chat / chatWithStructuredOutput / chatWithTools）
+     * 由外部（如 DI 容器）注入以实现全局 token 计量。
+     */
+    _onTokenUsage = null;
     constructor(config = {}) {
         this.model = config.model || '';
         this.apiKey = config.apiKey || '';
@@ -79,6 +84,25 @@ export class AiProvider {
     async chat(prompt, context = {}) {
         throw new Error(`${this.name}.chat() not implemented`);
     }
+    /**
+     * 从 API 原始响应中提取 token 用量并触发回调。
+     * 子类在 chat() / chatWithStructuredOutput() 中调用。
+     */
+    _emitTokenUsage(usage, source) {
+        if (!usage || !this._onTokenUsage) {
+            return;
+        }
+        const total = (usage.inputTokens || 0) + (usage.outputTokens || 0);
+        if (total === 0) {
+            return;
+        }
+        try {
+            this._onTokenUsage({ ...usage, source });
+        }
+        catch {
+            /* token tracking should never break execution */
+        }
+    }
     /** 摘要 - 对代码/文档生成结构化摘要 */
     async summarize(code) {
         throw new Error(`${this.name}.summarize() not implemented`);