autosnippet 3.2.10 → 3.2.12

package/dist/lib/shared/constants.d.ts

@@ -0,0 +1,208 @@
+/**
+ * 全局常量注册表 — 集中管理所有魔法数字和阈值
+ *
+ * 取代散落在各模块中的硬编码数字，方便统一调参和文档化。
+ *
+ * @module shared/constants
+ */
+/** QualityScorer 维度权重 */
+export declare const QUALITY_WEIGHTS: Readonly<{
+    completeness: 0.3;
+    format: 0.25;
+    codeQuality: 0.25;
+    metadata: 0.1;
+    engagement: 0.1;
+}>;
+/** QualityScorer 等级分界线 */
+export declare const QUALITY_GRADES: Readonly<{
+    A: 0.9;
+    B: 0.75;
+    C: 0.6;
+    D: 0.4;
+}>;
+/** 代码质量评估 — 合理长度范围 */
+export declare const CODE_LENGTH: Readonly<{
+    MIN: 10;
+    MAX: 5000;
+}>;
+/** RuleLearner 规则健康阈值 */
+export declare const RULE_LEARNER: Readonly<{
+    /** 触发高误报规则的条件 */
+    PROBLEMATIC_FALSE_POSITIVE_RATE: 0.3;
+    PROBLEMATIC_MIN_TRIGGERS: 5;
+    /** 规则建议置信度 */
+    CONFIDENCE_TUNE: 0.7;
+    CONFIDENCE_DISABLE: 0.8;
+    CONFIDENCE_SPECIALIZE: 0.6;
+    CONFIDENCE_REVIEW: 0.4;
+    /** 触发数阈值 */
+    HIGH_TRIGGER_COUNT: 50;
+    HIGH_PRECISION: 0.8;
+    /** 闲置天数阈值 */
+    UNUSED_DAYS_THRESHOLD: 30;
+    /** 精度下限 */
+    LOW_PRECISION: 0.5;
+}>;
+/** ComplianceReporter 默认 Quality Gate */
+export declare const QUALITY_GATE: Readonly<{
+    MAX_ERRORS: 0;
+    MAX_WARNINGS: 20;
+    MIN_SCORE: 70;
+}>;
+/** ComplianceReporter 扣分权重 */
+export declare const COMPLIANCE_SCORING: Readonly<{
+    ERROR_PENALTY: 5;
+    WARNING_PENALTY: 1;
+    INFO_PENALTY: 0.2;
+    PROBLEMATIC_RULE_PENALTY: 3;
+    HIGH_F1_BONUS: 5;
+    HIGH_F1_THRESHOLD: 0.8;
+    LOW_PRECISION_THRESHOLD: 0.5;
+    MAX_FILES_DEFAULT: 500;
+}>;
+/** 知识条目默认置信度和阈值 */
+export declare const KNOWLEDGE_CONFIDENCE: Readonly<{
+    /** 默认 confidence（Reasoning VO） */
+    DEFAULT: 0.7;
+    /** pending 条目纳入交付的最低 confidence */
+    PENDING_MIN: 0.7;
+    /** rankScore 中 confidence 缺省值 */
+    RANK_DEFAULT: 0.5;
+    /** Bootstrap refine 时的 AI 默认 confidence */
+    BOOTSTRAP_DEFAULT: 0.6;
+    /** 自动提交时的 bootstrap confidence */
+    BOOTSTRAP_SUBMIT: 0.8;
+}>;
+/** SearchEngine 配置 */
+export declare const SEARCH: Readonly<{
+    DEFAULT_LIMIT: 10;
+    MAX_RESULTS: 100;
+}>;
+/** FileWatcher 配置 */
+export declare const FILE_WATCHER: Readonly<{
+    DEBOUNCE_DELAY_MS: 300;
+    STABILITY_THRESHOLD_MS: 500;
+    POLL_INTERVAL_MS: 100;
+    BINARY_INTERVAL_MS: 300;
+    MAX_FILE_SIZE_BYTES: number;
+}>;
+/** AiProvider 熔断配置 */
+export declare const AI_CIRCUIT_BREAKER: Readonly<{
+    FAILURE_THRESHOLD: 5;
+}>;
+/** ToolResultCache 配置 */
+export declare const CACHE: Readonly<{
+    MAX_FILE_ENTRIES: 200;
+    MAX_SEARCH_ENTRIES: 500;
+    /** 缓存条目默认 TTL（毫秒），0 = 不过期 */
+    DEFAULT_TTL_MS: number;
+}>;
+/** PerformanceMonitor 配置 */
+export declare const MONITORING: Readonly<{
+    SLOW_REQUEST_THRESHOLD_MS: 1000;
+    ERROR_ALERT_THRESHOLD: 10;
+}>;
+/** CursorDeliveryPipeline 排序权重 */
+export declare const DELIVERY_RANK: Readonly<{
+    CONFIDENCE_WEIGHT: 50;
+    AUTHORITY_WEIGHT: 30;
+    USE_COUNT_MAX: 10;
+    USE_COUNT_WEIGHT: 2;
+    ACTIVE_BONUS: 10;
+}>;
+declare const _default: {
+    QUALITY_WEIGHTS: Readonly<{
+        completeness: 0.3;
+        format: 0.25;
+        codeQuality: 0.25;
+        metadata: 0.1;
+        engagement: 0.1;
+    }>;
+    QUALITY_GRADES: Readonly<{
+        A: 0.9;
+        B: 0.75;
+        C: 0.6;
+        D: 0.4;
+    }>;
+    CODE_LENGTH: Readonly<{
+        MIN: 10;
+        MAX: 5000;
+    }>;
+    RULE_LEARNER: Readonly<{
+        /** 触发高误报规则的条件 */
+        PROBLEMATIC_FALSE_POSITIVE_RATE: 0.3;
+        PROBLEMATIC_MIN_TRIGGERS: 5;
+        /** 规则建议置信度 */
+        CONFIDENCE_TUNE: 0.7;
+        CONFIDENCE_DISABLE: 0.8;
+        CONFIDENCE_SPECIALIZE: 0.6;
+        CONFIDENCE_REVIEW: 0.4;
+        /** 触发数阈值 */
+        HIGH_TRIGGER_COUNT: 50;
+        HIGH_PRECISION: 0.8;
+        /** 闲置天数阈值 */
+        UNUSED_DAYS_THRESHOLD: 30;
+        /** 精度下限 */
+        LOW_PRECISION: 0.5;
+    }>;
+    QUALITY_GATE: Readonly<{
+        MAX_ERRORS: 0;
+        MAX_WARNINGS: 20;
+        MIN_SCORE: 70;
+    }>;
+    COMPLIANCE_SCORING: Readonly<{
+        ERROR_PENALTY: 5;
+        WARNING_PENALTY: 1;
+        INFO_PENALTY: 0.2;
+        PROBLEMATIC_RULE_PENALTY: 3;
+        HIGH_F1_BONUS: 5;
+        HIGH_F1_THRESHOLD: 0.8;
+        LOW_PRECISION_THRESHOLD: 0.5;
+        MAX_FILES_DEFAULT: 500;
+    }>;
+    KNOWLEDGE_CONFIDENCE: Readonly<{
+        /** 默认 confidence（Reasoning VO） */
+        DEFAULT: 0.7;
+        /** pending 条目纳入交付的最低 confidence */
+        PENDING_MIN: 0.7;
+        /** rankScore 中 confidence 缺省值 */
+        RANK_DEFAULT: 0.5;
+        /** Bootstrap refine 时的 AI 默认 confidence */
+        BOOTSTRAP_DEFAULT: 0.6;
+        /** 自动提交时的 bootstrap confidence */
+        BOOTSTRAP_SUBMIT: 0.8;
+    }>;
+    SEARCH: Readonly<{
+        DEFAULT_LIMIT: 10;
+        MAX_RESULTS: 100;
+    }>;
+    FILE_WATCHER: Readonly<{
+        DEBOUNCE_DELAY_MS: 300;
+        STABILITY_THRESHOLD_MS: 500;
+        POLL_INTERVAL_MS: 100;
+        BINARY_INTERVAL_MS: 300;
+        MAX_FILE_SIZE_BYTES: number;
+    }>;
+    AI_CIRCUIT_BREAKER: Readonly<{
+        FAILURE_THRESHOLD: 5;
+    }>;
+    CACHE: Readonly<{
+        MAX_FILE_ENTRIES: 200;
+        MAX_SEARCH_ENTRIES: 500;
+        /** 缓存条目默认 TTL（毫秒），0 = 不过期 */
+        DEFAULT_TTL_MS: number;
+    }>;
+    MONITORING: Readonly<{
+        SLOW_REQUEST_THRESHOLD_MS: 1000;
+        ERROR_ALERT_THRESHOLD: 10;
+    }>;
+    DELIVERY_RANK: Readonly<{
+        CONFIDENCE_WEIGHT: 50;
+        AUTHORITY_WEIGHT: 30;
+        USE_COUNT_MAX: 10;
+        USE_COUNT_WEIGHT: 2;
+        ACTIVE_BONUS: 10;
+    }>;
+};
+export default _default;
+//# sourceMappingURL=constants.d.ts.map

package/dist/lib/shared/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../lib/shared/constants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,yBAAyB;AACzB,eAAO,MAAM,eAAe;;;;;;EAM1B,CAAC;AAEH,0BAA0B;AAC1B,eAAO,MAAM,cAAc;;;;;EAKzB,CAAC;AAEH,sBAAsB;AACtB,eAAO,MAAM,WAAW;;;EAGtB,CAAC;AAIH,yBAAyB;AACzB,eAAO,MAAM,YAAY;IACvB,iBAAiB;;;IAGjB,cAAc;;;;;IAKd,YAAY;;;IAGZ,aAAa;;IAEb,WAAW;;EAEX,CAAC;AAIH,yCAAyC;AACzC,eAAO,MAAM,YAAY;;;;EAIvB,CAAC;AAEH,8BAA8B;AAC9B,eAAO,MAAM,kBAAkB;;;;;;;;;EAS7B,CAAC;AAIH,mBAAmB;AACnB,eAAO,MAAM,oBAAoB;IAC/B,kCAAkC;;IAElC,mCAAmC;;IAEnC,iCAAiC;;IAEjC,2CAA2C;;IAE3C,kCAAkC;;EAElC,CAAC;AAIH,sBAAsB;AACtB,eAAO,MAAM,MAAM;;;EAGjB,CAAC;AAIH,qBAAqB;AACrB,eAAO,MAAM,YAAY;;;;;;EAMvB,CAAC;AAIH,sBAAsB;AACtB,eAAO,MAAM,kBAAkB;;EAE7B,CAAC;AAIH,yBAAyB;AACzB,eAAO,MAAM,KAAK;;;IAGhB,6BAA6B;;EAE7B,CAAC;AAIH,4BAA4B;AAC5B,eAAO,MAAM,UAAU;;;EAGrB,CAAC;AAIH,kCAAkC;AAClC,eAAO,MAAM,aAAa;;;;;;EAMxB,CAAC;;;;;;;;;;;;;;;;;;;;QA3GD,iBAAiB;;;QAGjB,cAAc;;;;;QAKd,YAAY;;;QAGZ,aAAa;;QAEb,WAAW;;;;;;;;;;;;;;;;;;;QA6BX,kCAAkC;;QAElC,mCAAmC;;QAEnC,iCAAiC;;QAEjC,2CAA2C;;QAE3C,kCAAkC;;;;;;;;;;;;;;;;;;;;QAoClC,6BAA6B;;;;;;;;;;;;;;;AAuB/B,wBAcE"}

package/dist/lib/shared/constants.js

@@ -0,0 +1,138 @@
+/**
+ * 全局常量注册表 — 集中管理所有魔法数字和阈值
+ *
+ * 取代散落在各模块中的硬编码数字，方便统一调参和文档化。
+ *
+ * @module shared/constants
+ */
+// ─── 质量评分 ───────────────────────────────────────────
+/** QualityScorer 维度权重 */
+export const QUALITY_WEIGHTS = Object.freeze({
+    completeness: 0.3,
+    format: 0.25,
+    codeQuality: 0.25,
+    metadata: 0.1,
+    engagement: 0.1,
+});
+/** QualityScorer 等级分界线 */
+export const QUALITY_GRADES = Object.freeze({
+    A: 0.9,
+    B: 0.75,
+    C: 0.6,
+    D: 0.4,
+});
+/** 代码质量评估 — 合理长度范围 */
+export const CODE_LENGTH = Object.freeze({
+    MIN: 10,
+    MAX: 5000,
+});
+// ─── Guard 规则学习 ──────────────────────────────────────
+/** RuleLearner 规则健康阈值 */
+export const RULE_LEARNER = Object.freeze({
+    /** 触发高误报规则的条件 */
+    PROBLEMATIC_FALSE_POSITIVE_RATE: 0.3,
+    PROBLEMATIC_MIN_TRIGGERS: 5,
+    /** 规则建议置信度 */
+    CONFIDENCE_TUNE: 0.7,
+    CONFIDENCE_DISABLE: 0.8,
+    CONFIDENCE_SPECIALIZE: 0.6,
+    CONFIDENCE_REVIEW: 0.4,
+    /** 触发数阈值 */
+    HIGH_TRIGGER_COUNT: 50,
+    HIGH_PRECISION: 0.8,
+    /** 闲置天数阈值 */
+    UNUSED_DAYS_THRESHOLD: 30,
+    /** 精度下限 */
+    LOW_PRECISION: 0.5,
+});
+// ─── 合规报告 ────────────────────────────────────────────
+/** ComplianceReporter 默认 Quality Gate */
+export const QUALITY_GATE = Object.freeze({
+    MAX_ERRORS: 0,
+    MAX_WARNINGS: 20,
+    MIN_SCORE: 70,
+});
+/** ComplianceReporter 扣分权重 */
+export const COMPLIANCE_SCORING = Object.freeze({
+    ERROR_PENALTY: 5,
+    WARNING_PENALTY: 1,
+    INFO_PENALTY: 0.2,
+    PROBLEMATIC_RULE_PENALTY: 3,
+    HIGH_F1_BONUS: 5,
+    HIGH_F1_THRESHOLD: 0.8,
+    LOW_PRECISION_THRESHOLD: 0.5,
+    MAX_FILES_DEFAULT: 500,
+});
+// ─── 知识置信度 ──────────────────────────────────────────
+/** 知识条目默认置信度和阈值 */
+export const KNOWLEDGE_CONFIDENCE = Object.freeze({
+    /** 默认 confidence（Reasoning VO） */
+    DEFAULT: 0.7,
+    /** pending 条目纳入交付的最低 confidence */
+    PENDING_MIN: 0.7,
+    /** rankScore 中 confidence 缺省值 */
+    RANK_DEFAULT: 0.5,
+    /** Bootstrap refine 时的 AI 默认 confidence */
+    BOOTSTRAP_DEFAULT: 0.6,
+    /** 自动提交时的 bootstrap confidence */
+    BOOTSTRAP_SUBMIT: 0.8,
+});
+// ─── 搜索管线 ────────────────────────────────────────────
+/** SearchEngine 配置 */
+export const SEARCH = Object.freeze({
+    DEFAULT_LIMIT: 10,
+    MAX_RESULTS: 100,
+});
+// ─── 文件监听器 ──────────────────────────────────────────
+/** FileWatcher 配置 */
+export const FILE_WATCHER = Object.freeze({
+    DEBOUNCE_DELAY_MS: 300,
+    STABILITY_THRESHOLD_MS: 500,
+    POLL_INTERVAL_MS: 100,
+    BINARY_INTERVAL_MS: 300,
+    MAX_FILE_SIZE_BYTES: 1024 * 1024,
+});
+// ─── AI Provider ─────────────────────────────────────────
+/** AiProvider 熔断配置 */
+export const AI_CIRCUIT_BREAKER = Object.freeze({
+    FAILURE_THRESHOLD: 5,
+});
+// ─── 缓存 ────────────────────────────────────────────────
+/** ToolResultCache 配置 */
+export const CACHE = Object.freeze({
+    MAX_FILE_ENTRIES: 200,
+    MAX_SEARCH_ENTRIES: 500,
+    /** 缓存条目默认 TTL（毫秒），0 = 不过期 */
+    DEFAULT_TTL_MS: 30 * 60 * 1000, // 30 分钟
+});
+// ─── 性能监控 ────────────────────────────────────────────
+/** PerformanceMonitor 配置 */
+export const MONITORING = Object.freeze({
+    SLOW_REQUEST_THRESHOLD_MS: 1000,
+    ERROR_ALERT_THRESHOLD: 10,
+});
+// ─── Cursor 交付 ─────────────────────────────────────────
+/** CursorDeliveryPipeline 排序权重 */
+export const DELIVERY_RANK = Object.freeze({
+    CONFIDENCE_WEIGHT: 50,
+    AUTHORITY_WEIGHT: 30,
+    USE_COUNT_MAX: 10,
+    USE_COUNT_WEIGHT: 2,
+    ACTIVE_BONUS: 10,
+});
+export default {
+    QUALITY_WEIGHTS,
+    QUALITY_GRADES,
+    CODE_LENGTH,
+    RULE_LEARNER,
+    QUALITY_GATE,
+    COMPLIANCE_SCORING,
+    KNOWLEDGE_CONFIDENCE,
+    SEARCH,
+    FILE_WATCHER,
+    AI_CIRCUIT_BREAKER,
+    CACHE,
+    MONITORING,
+    DELIVERY_RANK,
+};
+//# sourceMappingURL=constants.js.map

package/dist/lib/shared/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../lib/shared/constants.ts"],"names":[],"mappings":"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"}

package/dist/lib/shared/errors/BaseError.d.ts

@@ -0,0 +1,60 @@
+/**
+ * BaseError - 所有错误的基类
+ */
+export declare class BaseError extends Error {
+    code: string;
+    statusCode: number;
+    constructor(message: string, code: string, statusCode?: number);
+    toJSON(): {
+        name: string;
+        code: string;
+        message: string;
+        statusCode: number;
+    };
+}
+/**
+ * PermissionDenied - 权限拒绝错误
+ */
+export declare class PermissionDenied extends BaseError {
+    constructor(message: string);
+}
+/**
+ * ConstitutionViolation - 宪法违反错误
+ */
+export declare class ConstitutionViolation extends BaseError {
+    violations: Array<{
+        rule: string;
+    }>;
+    constructor(violations: Array<{
+        rule: string;
+    }>);
+}
+/**
+ * ValidationError - 验证错误
+ */
+export declare class ValidationError extends BaseError {
+    details: Record<string, unknown>;
+    constructor(message: string, details?: Record<string, unknown>);
+}
+/**
+ * NotFoundError - 资源未找到错误
+ */
+export declare class NotFoundError extends BaseError {
+    resource: string | undefined;
+    resourceId: string | undefined;
+    constructor(message: string, resource?: string, resourceId?: string);
+}
+/**
+ * ConflictError - 资源冲突错误
+ */
+export declare class ConflictError extends BaseError {
+    details: Record<string, unknown>;
+    constructor(message: string, details: Record<string, unknown>);
+}
+/**
+ * InternalError - 内部错误
+ */
+export declare class InternalError extends BaseError {
+    constructor(message: string);
+}
+//# sourceMappingURL=BaseError.d.ts.map

package/dist/lib/shared/errors/BaseError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseError.d.ts","sourceRoot":"","sources":["../../../../lib/shared/errors/BaseError.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;gBACP,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,SAAM;IAQ3D,MAAM;;;;;;CAQP;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,SAAS;gBACjC,OAAO,EAAE,MAAM;CAG5B;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,SAAS;IAClD,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;gBACxB,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAKhD;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,SAAS;IAC5C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBACrB,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAInE;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,SAAS;IAC1C,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;gBACnB,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAgBpE;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,SAAS;IAC1C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBACrB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI9D;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,SAAS;gBAC9B,OAAO,EAAE,MAAM;CAG5B"}

package/dist/lib/shared/errors/BaseError.js

@@ -0,0 +1,93 @@
+/**
+ * BaseError - 所有错误的基类
+ */
+export class BaseError extends Error {
+    code;
+    statusCode;
+    constructor(message, code, statusCode = 500) {
+        super(message);
+        this.code = code;
+        this.statusCode = statusCode;
+        this.name = this.constructor.name;
+        Error.captureStackTrace(this, this.constructor);
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            code: this.code,
+            message: this.message,
+            statusCode: this.statusCode,
+        };
+    }
+}
+/**
+ * PermissionDenied - 权限拒绝错误
+ */
+export class PermissionDenied extends BaseError {
+    constructor(message) {
+        super(message, 'PERMISSION_DENIED', 403);
+    }
+}
+/**
+ * ConstitutionViolation - 宪法违反错误
+ */
+export class ConstitutionViolation extends BaseError {
+    violations;
+    constructor(violations) {
+        const message = `Constitution violation: ${violations.map((v) => v.rule).join(', ')}`;
+        super(message, 'CONSTITUTION_VIOLATION', 400);
+        this.violations = violations;
+    }
+}
+/**
+ * ValidationError - 验证错误
+ */
+export class ValidationError extends BaseError {
+    details;
+    constructor(message, details = {}) {
+        super(message, 'VALIDATION_ERROR', 400);
+        this.details = details;
+    }
+}
+/**
+ * NotFoundError - 资源未找到错误
+ */
+export class NotFoundError extends BaseError {
+    resource;
+    resourceId;
+    constructor(message, resource, resourceId) {
+        // 如果没有提供 message，那么第一个参数就是 resource
+        let finalMessage = message;
+        let finalResource = resource;
+        if (!resource) {
+            finalMessage = `Resource not found: ${message}`;
+            finalResource = message;
+        }
+        else if (resourceId) {
+            finalMessage = `${message} (${resource}:${resourceId})`;
+        }
+        super(finalMessage, 'NOT_FOUND', 404);
+        this.resource = finalResource;
+        this.resourceId = resourceId;
+    }
+}
+/**
+ * ConflictError - 资源冲突错误
+ */
+export class ConflictError extends BaseError {
+    details;
+    constructor(message, details) {
+        super(message, 'CONFLICT', 409);
+        this.details = details;
+    }
+}
+/**
+ * InternalError - 内部错误
+ */
+export class InternalError extends BaseError {
+    constructor(message) {
+        super(message, 'INTERNAL_ERROR', 500);
+    }
+}
+/* 默认导出已移除 — 使用命名导入: import { ValidationError } from '...' */
+//# sourceMappingURL=BaseError.js.map

package/dist/lib/shared/errors/BaseError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseError.js","sourceRoot":"","sources":["../../../../lib/shared/errors/BaseError.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClC,IAAI,CAAS;IACb,UAAU,CAAS;IACnB,YAAY,OAAe,EAAE,IAAY,EAAE,UAAU,GAAG,GAAG;QACzD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC;IAED,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC;IACJ,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,SAAS;IAC7C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,mBAAmB,EAAE,GAAG,CAAC,CAAC;IAC3C,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,SAAS;IAClD,UAAU,CAA0B;IACpC,YAAY,UAAmC;QAC7C,MAAM,OAAO,GAAG,2BAA2B,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACtF,KAAK,CAAC,OAAO,EAAE,wBAAwB,EAAE,GAAG,CAAC,CAAC;QAC9C,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,SAAS;IAC5C,OAAO,CAA0B;IACjC,YAAY,OAAe,EAAE,UAAmC,EAAE;QAChE,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,SAAS;IAC1C,QAAQ,CAAqB;IAC7B,UAAU,CAAqB;IAC/B,YAAY,OAAe,EAAE,QAAiB,EAAE,UAAmB;QACjE,oCAAoC;QACpC,IAAI,YAAY,GAAG,OAAO,CAAC;QAC3B,IAAI,aAAa,GAAG,QAAQ,CAAC;QAE7B,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,YAAY,GAAG,uBAAuB,OAAO,EAAE,CAAC;YAChD,aAAa,GAAG,OAAO,CAAC;QAC1B,CAAC;aAAM,IAAI,UAAU,EAAE,CAAC;YACtB,YAAY,GAAG,GAAG,OAAO,KAAK,QAAQ,IAAI,UAAU,GAAG,CAAC;QAC1D,CAAC;QAED,KAAK,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC;QACtC,IAAI,CAAC,QAAQ,GAAG,aAAa,CAAC;QAC9B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,SAAS;IAC1C,OAAO,CAA0B;IACjC,YAAY,OAAe,EAAE,OAAgC;QAC3D,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,SAAS;IAC1C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,CAAC,CAAC;IACxC,CAAC;CACF;AAED,6DAA6D"}

package/dist/lib/shared/errors/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Errors 层索引
+ * 导出所有错误类
+ */
+export { BaseError, ConflictError, ConstitutionViolation, InternalError, NotFoundError, PermissionDenied, ValidationError, } from './BaseError.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/shared/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../lib/shared/errors/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,SAAS,EACT,aAAa,EACb,qBAAqB,EACrB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,eAAe,GAChB,MAAM,gBAAgB,CAAC"}

package/dist/lib/shared/errors/index.js

@@ -0,0 +1,6 @@
+/**
+ * Errors 层索引
+ * 导出所有错误类
+ */
+export { BaseError, ConflictError, ConstitutionViolation, InternalError, NotFoundError, PermissionDenied, ValidationError, } from './BaseError.js';
+//# sourceMappingURL=index.js.map

package/dist/lib/shared/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../lib/shared/errors/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,SAAS,EACT,aAAa,EACb,qBAAqB,EACrB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,eAAe,GAChB,MAAM,gBAAgB,CAAC"}

package/dist/lib/shared/isOwnDevRepo.d.ts

@@ -0,0 +1,21 @@
+/**
+ * isOwnDevRepo — 检测当前 projectRoot 是否是 AutoSnippet 自身的开发仓库
+ *
+ * 用于防止 MCP 服务器 / CLI 在开发环境中把源码仓库当做用户项目，
+ * 避免在开发仓库内创建 `.autosnippet/` 和 `AutoSnippet/candidates/` 等运行时数据。
+ *
+ * 检测条件（三者同时满足）：
+ *  1. projectRoot/package.json 的 name === 'autosnippet'
+ *  2. projectRoot/lib/bootstrap.ts 存在（源码标记）
+ *  3. projectRoot/SOUL.md 存在（项目灵魂文档）
+ */
+/**
+ * 判断 dir 是否是 AutoSnippet 自身的源码开发仓库
+ * 结果按 dir 缓存，避免重复 IO
+ */
+export declare function isAutoSnippetDevRepo(dir: string): boolean;
+/**
+ * 重置缓存（仅用于测试）
+ */
+export declare function _resetDevRepoCache(): void;
+//# sourceMappingURL=isOwnDevRepo.d.ts.map

package/dist/lib/shared/isOwnDevRepo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isOwnDevRepo.d.ts","sourceRoot":"","sources":["../../../lib/shared/isOwnDevRepo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CA2BzD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,SAEjC"}

package/dist/lib/shared/isOwnDevRepo.js

@@ -0,0 +1,53 @@
+/**
+ * isOwnDevRepo — 检测当前 projectRoot 是否是 AutoSnippet 自身的开发仓库
+ *
+ * 用于防止 MCP 服务器 / CLI 在开发环境中把源码仓库当做用户项目，
+ * 避免在开发仓库内创建 `.autosnippet/` 和 `AutoSnippet/candidates/` 等运行时数据。
+ *
+ * 检测条件（三者同时满足）：
+ *  1. projectRoot/package.json 的 name === 'autosnippet'
+ *  2. projectRoot/lib/bootstrap.ts 存在（源码标记）
+ *  3. projectRoot/SOUL.md 存在（项目灵魂文档）
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+/** 多路径缓存（同一进程可能检测多个目录） */
+const _cache = new Map();
+/**
+ * 判断 dir 是否是 AutoSnippet 自身的源码开发仓库
+ * 结果按 dir 缓存，避免重复 IO
+ */
+export function isAutoSnippetDevRepo(dir) {
+    const resolved = path.resolve(dir);
+    const cached = _cache.get(resolved);
+    if (cached !== undefined) {
+        return cached;
+    }
+    let result = false;
+    try {
+        // 条件 1: package.json name === 'autosnippet'
+        const pkgPath = path.join(resolved, 'package.json');
+        if (fs.existsSync(pkgPath)) {
+            const raw = fs.readFileSync(pkgPath, 'utf-8');
+            const pkg = JSON.parse(raw);
+            if (pkg.name === 'autosnippet') {
+                // 条件 2 & 3: 源码标记文件同时存在
+                const hasBootstrap = fs.existsSync(path.join(resolved, 'lib', 'bootstrap.ts'));
+                const hasSoul = fs.existsSync(path.join(resolved, 'SOUL.md'));
+                result = hasBootstrap && hasSoul;
+            }
+        }
+    }
+    catch {
+        // 读取失败 → 不是开发仓库
+    }
+    _cache.set(resolved, result);
+    return result;
+}
+/**
+ * 重置缓存（仅用于测试）
+ */
+export function _resetDevRepoCache() {
+    _cache.clear();
+}
+//# sourceMappingURL=isOwnDevRepo.js.map

package/dist/lib/shared/isOwnDevRepo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isOwnDevRepo.js","sourceRoot":"","sources":["../../../lib/shared/isOwnDevRepo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,0BAA0B;AAC1B,MAAM,MAAM,GAAG,IAAI,GAAG,EAAmB,CAAC;AAE1C;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACpC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,CAAC;QACH,4CAA4C;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;QACpD,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAsB,CAAC;YACjD,IAAI,GAAG,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;gBAC/B,uBAAuB;gBACvB,MAAM,YAAY,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC;gBAC/E,MAAM,OAAO,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;gBAC9D,MAAM,GAAG,YAAY,IAAI,OAAO,CAAC;YACnC,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,gBAAgB;IAClB,CAAC;IAED,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,CAAC,KAAK,EAAE,CAAC;AACjB,CAAC"}

package/dist/lib/shared/package-root.d.ts

@@ -0,0 +1,13 @@
+/** AutoSnippet 包的根目录（包含 package.json 的目录） */
+export declare const PACKAGE_ROOT: string;
+/** `<root>/config/` — 配置文件目录 */
+export declare const CONFIG_DIR: string;
+/** `<root>/skills/` — 技能目录 */
+export declare const SKILLS_DIR: string;
+/** `<root>/templates/` — 模板目录 */
+export declare const TEMPLATES_DIR: string;
+/** `<root>/resources/` — 静态资源目录 */
+export declare const RESOURCES_DIR: string;
+/** `<root>/dashboard/` — Dashboard 前端目录 */
+export declare const DASHBOARD_DIR: string;
+//# sourceMappingURL=package-root.d.ts.map

package/dist/lib/shared/package-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-root.d.ts","sourceRoot":"","sources":["../../../lib/shared/package-root.ts"],"names":[],"mappings":"AAkDA,6CAA6C;AAC7C,eAAO,MAAM,YAAY,QAAoB,CAAC;AAE9C,gCAAgC;AAChC,eAAO,MAAM,UAAU,QAAoC,CAAC;AAE5D,8BAA8B;AAC9B,eAAO,MAAM,UAAU,QAAoC,CAAC;AAE5D,iCAAiC;AACjC,eAAO,MAAM,aAAa,QAAuC,CAAC;AAElE,mCAAmC;AACnC,eAAO,MAAM,aAAa,QAAuC,CAAC;AAElE,2CAA2C;AAC3C,eAAO,MAAM,aAAa,QAAuC,CAAC"}