@clawplays/ospec-cli 0.1.1

package/dist/advanced/BatchOperations.d.ts

@@ -0,0 +1,36 @@
+import { FeatureState } from '../core/types';
+export interface BatchOperationResult {
+    successful: number;
+    failed: number;
+    skipped: number;
+    errors: Array<{
+        feature: string;
+        error: string;
+    }>;
+}
+export interface BatchQuery {
+    status?: string;
+    tags?: string[];
+    minProgress?: number;
+    maxProgress?: number;
+    createdAfter?: string;
+    createdBefore?: string;
+}
+export declare class BatchOperations {
+    queryFeatures(projectDir: string, query: BatchQuery): Promise<FeatureState[]>;
+    batchOperation(projectDir: string, query: BatchQuery, operation: (state: FeatureState, featurePath: string) => Promise<void>): Promise<BatchOperationResult>;
+    exportFeatures(projectDir: string, query: BatchQuery): Promise<{
+        count: number;
+        features: FeatureState[];
+        timestamp: string;
+    }>;
+    importFeatures(projectDir: string, features: FeatureState[]): Promise<BatchOperationResult>;
+    getStatistics(projectDir: string): Promise<{
+        total: number;
+        byStatus: Record<string, number>;
+        byMode: Record<string, number>;
+    }>;
+    private matchesQuery;
+}
+export declare const batchOperations: BatchOperations;
+//# sourceMappingURL=BatchOperations.d.ts.map

package/dist/advanced/BatchOperations.js

@@ -0,0 +1,159 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.batchOperations = exports.BatchOperations = void 0;
+const path = __importStar(require("path"));
+const constants_1 = require("../core/constants");
+const services_1 = require("../services");
+class BatchOperations {
+    async queryFeatures(projectDir, query) {
+        const featuresDir = path.join(projectDir, constants_1.DIR_NAMES.CHANGES, constants_1.DIR_NAMES.ACTIVE);
+        const results = [];
+        try {
+            const featureFolders = await services_1.services.fileService.readDir(featuresDir);
+            for (const featureName of featureFolders) {
+                const featurePath = path.join(featuresDir, featureName);
+                const statePath = path.join(featurePath, constants_1.FILE_NAMES.STATE);
+                if (!(await services_1.services.fileService.exists(statePath))) {
+                    continue;
+                }
+                const state = await services_1.services.fileService.readJSON(statePath);
+                if (this.matchesQuery(state, query)) {
+                    results.push(state);
+                }
+            }
+        }
+        catch (error) {
+            services_1.services.logger.warn(`Query failed: ${error}`);
+        }
+        return results;
+    }
+    async batchOperation(projectDir, query, operation) {
+        const result = {
+            successful: 0,
+            failed: 0,
+            skipped: 0,
+            errors: [],
+        };
+        const features = await this.queryFeatures(projectDir, query);
+        const featuresDir = path.join(projectDir, constants_1.DIR_NAMES.CHANGES, constants_1.DIR_NAMES.ACTIVE);
+        for (const feature of features) {
+            try {
+                await operation(feature, path.join(featuresDir, feature.feature));
+                result.successful++;
+            }
+            catch (error) {
+                result.failed++;
+                result.errors.push({
+                    feature: feature.feature,
+                    error: String(error),
+                });
+            }
+        }
+        return result;
+    }
+    async exportFeatures(projectDir, query) {
+        const features = await this.queryFeatures(projectDir, query);
+        return {
+            count: features.length,
+            features,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    async importFeatures(projectDir, features) {
+        const result = {
+            successful: 0,
+            failed: 0,
+            skipped: 0,
+            errors: [],
+        };
+        const featuresDir = path.join(projectDir, constants_1.DIR_NAMES.CHANGES, constants_1.DIR_NAMES.ACTIVE);
+        for (const feature of features) {
+            try {
+                const featurePath = path.join(featuresDir, feature.feature);
+                const statePath = path.join(featurePath, constants_1.FILE_NAMES.STATE);
+                if (await services_1.services.fileService.exists(statePath)) {
+                    result.skipped++;
+                    continue;
+                }
+                await services_1.services.fileService.ensureDir(featurePath);
+                await services_1.services.fileService.writeJSON(statePath, feature);
+                result.successful++;
+            }
+            catch (error) {
+                result.failed++;
+                result.errors.push({
+                    feature: feature.feature,
+                    error: String(error),
+                });
+            }
+        }
+        return result;
+    }
+    async getStatistics(projectDir) {
+        const features = await this.queryFeatures(projectDir, {});
+        const stats = {
+            total: features.length,
+            byStatus: {},
+            byMode: {},
+        };
+        for (const feature of features) {
+            if (!stats.byStatus[feature.status]) {
+                stats.byStatus[feature.status] = 0;
+            }
+            stats.byStatus[feature.status]++;
+            if (!stats.byMode[feature.mode]) {
+                stats.byMode[feature.mode] = 0;
+            }
+            stats.byMode[feature.mode]++;
+        }
+        return stats;
+    }
+    matchesQuery(state, query) {
+        if (query.status && state.status !== query.status) {
+            return false;
+        }
+        if (query.tags && query.tags.length > 0) {
+            const hasMatchingTag = query.tags.some(tag => (state.pending || []).includes(tag));
+            if (!hasMatchingTag) {
+                return false;
+            }
+        }
+        return true;
+    }
+}
+exports.BatchOperations = BatchOperations;
+exports.batchOperations = new BatchOperations();
+//# sourceMappingURL=BatchOperations.js.map

package/dist/advanced/CachingLayer.d.ts

@@ -0,0 +1,66 @@
+/**
+ * 缓存层系统
+ * 优化性能和减少磁盘访问
+ */
+export interface CacheEntry<T> {
+    key: string;
+    value: T;
+    timestamp: number;
+    ttl?: number;
+}
+export declare class CachingLayer<T = any> {
+    private cache;
+    private stats;
+    private maxSize;
+    private cleanupInterval?;
+    constructor(maxSize?: number);
+    /**
+     * 设置缓存值
+     */
+    set(key: string, value: T, ttl?: number): void;
+    /**
+     * 获取缓存值
+     */
+    get(key: string): T | null;
+    /**
+     * 检查键是否存在
+     */
+    has(key: string): boolean;
+    /**
+     * 删除缓存
+     */
+    delete(key: string): boolean;
+    /**
+     * 清空缓存
+     */
+    clear(): void;
+    /**
+     * 获取缓存大小
+     */
+    size(): number;
+    /**
+     * 获取统计信息
+     */
+    getStats(): {
+        hits: number;
+        misses: number;
+        evictions: number;
+        hitRate: number;
+        currentSize: number;
+        maxSize: number;
+    };
+    /**
+     * 启动清理过期条目
+     */
+    private startCleanup;
+    /**
+     * 停止清理
+     */
+    stopCleanup(): void;
+    /**
+     * 销毁缓存
+     */
+    destroy(): void;
+}
+export declare const cachingLayer: CachingLayer<any>;
+//# sourceMappingURL=CachingLayer.d.ts.map

package/dist/advanced/CachingLayer.js

@@ -0,0 +1,136 @@
+"use strict";
+/**
+ * 缓存层系统
+ * 优化性能和减少磁盘访问
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cachingLayer = exports.CachingLayer = void 0;
+class CachingLayer {
+    constructor(maxSize = 1000) {
+        this.cache = new Map();
+        this.stats = {
+            hits: 0,
+            misses: 0,
+            evictions: 0,
+        };
+        this.maxSize = 1000;
+        this.maxSize = maxSize;
+        this.startCleanup();
+    }
+    /**
+     * 设置缓存值
+     */
+    set(key, value, ttl) {
+        // 如果超过最大大小，移除最旧的条目
+        if (this.cache.size >= this.maxSize) {
+            const oldestKey = Array.from(this.cache.entries()).sort((a, b) => a[1].timestamp - b[1].timestamp)[0]?.[0];
+            if (oldestKey) {
+                this.cache.delete(oldestKey);
+                this.stats.evictions++;
+            }
+        }
+        const entry = {
+            key,
+            value,
+            timestamp: Date.now(),
+            ttl,
+        };
+        this.cache.set(key, entry);
+    }
+    /**
+     * 获取缓存值
+     */
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            this.stats.misses++;
+            return null;
+        }
+        // 检查是否过期
+        if (entry.ttl && Date.now() - entry.timestamp > entry.ttl) {
+            this.cache.delete(key);
+            this.stats.misses++;
+            return null;
+        }
+        this.stats.hits++;
+        return entry.value;
+    }
+    /**
+     * 检查键是否存在
+     */
+    has(key) {
+        return this.get(key) !== null;
+    }
+    /**
+     * 删除缓存
+     */
+    delete(key) {
+        return this.cache.delete(key);
+    }
+    /**
+     * 清空缓存
+     */
+    clear() {
+        this.cache.clear();
+    }
+    /**
+     * 获取缓存大小
+     */
+    size() {
+        return this.cache.size;
+    }
+    /**
+     * 获取统计信息
+     */
+    getStats() {
+        const total = this.stats.hits + this.stats.misses;
+        const hitRate = total > 0 ? (this.stats.hits / total * 100).toFixed(2) : '0';
+        return {
+            hits: this.stats.hits,
+            misses: this.stats.misses,
+            evictions: this.stats.evictions,
+            hitRate: parseFloat(hitRate),
+            currentSize: this.cache.size,
+            maxSize: this.maxSize,
+        };
+    }
+    /**
+     * 启动清理过期条目
+     */
+    startCleanup() {
+        this.cleanupInterval = setInterval(() => {
+            const now = Date.now();
+            let removed = 0;
+            for (const [key, entry] of this.cache.entries()) {
+                if (entry.ttl && now - entry.timestamp > entry.ttl) {
+                    this.cache.delete(key);
+                    removed++;
+                }
+            }
+            if (removed > 0) {
+                this.stats.evictions += removed;
+            }
+        }, 60000); // 每分钟检查一次
+        // Do not keep unrelated CLI commands alive just because the cache module was imported.
+        this.cleanupInterval.unref?.();
+    }
+    /**
+     * 停止清理
+     */
+    stopCleanup() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = undefined;
+        }
+    }
+    /**
+     * 销毁缓存
+     */
+    destroy() {
+        this.stopCleanup();
+        this.clear();
+    }
+}
+exports.CachingLayer = CachingLayer;
+exports.cachingLayer = new CachingLayer();
+//# sourceMappingURL=CachingLayer.js.map

package/dist/advanced/FeatureUpdater.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 特性更新系统
+ * 处理特性的更新和迁移
+ */
+import { FeatureState, FeatureStatus } from '../core/types';
+export interface UpdateOptions {
+    status?: FeatureStatus;
+    description?: string;
+    tags?: string[];
+    affects?: string[];
+}
+export interface UpdateLog {
+    timestamp: string;
+    type: 'status' | 'property' | 'metadata';
+    changes: Record<string, any>;
+    author?: string;
+}
+export declare class FeatureUpdater {
+    private updateLogs;
+    /**
+     * 更新特性属性
+     */
+    updateFeature(featurePath: string, options: UpdateOptions): Promise<FeatureState>;
+    /**
+     * 批量更新特性
+     */
+    batchUpdateFeatures(projectDir: string, filter: (state: FeatureState) => boolean, updates: UpdateOptions): Promise<FeatureState[]>;
+    /**
+     * 迁移特性版本
+     */
+    migrateFeature(featurePath: string, targetVersion: string): Promise<void>;
+    /**
+     * 记录更新日志
+     */
+    private logUpdate;
+    /**
+     * 获取更新日志
+     */
+    getUpdateLogs(): UpdateLog[];
+    /**
+     * 清空日志
+     */
+    clearLogs(): void;
+}
+export declare const featureUpdater: FeatureUpdater;
+//# sourceMappingURL=FeatureUpdater.d.ts.map

package/dist/advanced/FeatureUpdater.js

@@ -0,0 +1,151 @@
+"use strict";
+/**
+ * 特性更新系统
+ * 处理特性的更新和迁移
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.featureUpdater = exports.FeatureUpdater = void 0;
+const path = __importStar(require("path"));
+const services_1 = require("../services");
+const constants_1 = require("../core/constants");
+class FeatureUpdater {
+    constructor() {
+        this.updateLogs = [];
+    }
+    /**
+     * 更新特性属性
+     */
+    async updateFeature(featurePath, options) {
+        const statePath = path.join(featurePath, constants_1.FILE_NAMES.STATE);
+        const state = await services_1.services.fileService.readJSON(statePath);
+        const changes = {};
+        // 更新状态
+        if (options.status && options.status !== state.status) {
+            changes.status = options.status;
+            state.status = options.status;
+        }
+        // 更新描述（存在proposal中）
+        if (options.description) {
+            const proposalPath = path.join(featurePath, 'proposal', 'PROPOSAL.md');
+            const proposalExists = await services_1.services.fileService.exists(proposalPath);
+            if (proposalExists) {
+                changes.description = options.description;
+            }
+        }
+        // 更新标签
+        if (options.tags && JSON.stringify(options.tags) !== JSON.stringify(state.pending)) {
+            changes.tags = options.tags;
+        }
+        // 更新受影响模块
+        if (options.affects && JSON.stringify(options.affects) !== JSON.stringify(state.affects)) {
+            changes.affects = options.affects;
+            state.affects = options.affects;
+        }
+        // 记录更新日志
+        if (Object.keys(changes).length > 0) {
+            this.logUpdate('property', changes);
+            state.last_updated = new Date().toISOString();
+            await services_1.services.fileService.writeJSON(statePath, state);
+        }
+        return state;
+    }
+    /**
+     * 批量更新特性
+     */
+    async batchUpdateFeatures(projectDir, filter, updates) {
+        const featuresDir = path.join(projectDir, 'features');
+        const features = [];
+        try {
+            const featureFolders = await services_1.services.fileService.readDir(featuresDir);
+            for (const featureName of featureFolders) {
+                const featurePath = path.join(featuresDir, featureName);
+                const statePath = path.join(featurePath, constants_1.FILE_NAMES.STATE);
+                const exists = await services_1.services.fileService.exists(statePath);
+                if (!exists)
+                    continue;
+                const state = await services_1.services.fileService.readJSON(statePath);
+                if (filter(state)) {
+                    const updated = await this.updateFeature(featurePath, updates);
+                    features.push(updated);
+                }
+            }
+        }
+        catch (error) {
+            services_1.services.logger.warn(`Failed to batch update: ${error}`);
+        }
+        return features;
+    }
+    /**
+     * 迁移特性版本
+     */
+    async migrateFeature(featurePath, targetVersion) {
+        const statePath = path.join(featurePath, constants_1.FILE_NAMES.STATE);
+        const state = await services_1.services.fileService.readJSON(statePath);
+        const oldVersion = state.version;
+        state.version = targetVersion;
+        state.last_updated = new Date().toISOString();
+        await services_1.services.fileService.writeJSON(statePath, state);
+        this.logUpdate('metadata', {
+            versionMigration: { from: oldVersion, to: targetVersion },
+        });
+    }
+    /**
+     * 记录更新日志
+     */
+    logUpdate(type, changes) {
+        const log = {
+            timestamp: new Date().toISOString(),
+            type,
+            changes,
+        };
+        this.updateLogs.push(log);
+    }
+    /**
+     * 获取更新日志
+     */
+    getUpdateLogs() {
+        return this.updateLogs;
+    }
+    /**
+     * 清空日志
+     */
+    clearLogs() {
+        this.updateLogs = [];
+    }
+}
+exports.FeatureUpdater = FeatureUpdater;
+exports.featureUpdater = new FeatureUpdater();
+//# sourceMappingURL=FeatureUpdater.js.map

package/dist/advanced/PerformanceMonitor.d.ts

@@ -0,0 +1,52 @@
+/**
+ * 性能监控系统
+ * 跟踪和优化系统性能
+ */
+export interface PerformanceMetric {
+    name: string;
+    duration: number;
+    timestamp: string;
+    metadata?: Record<string, any>;
+}
+export interface PerformanceSummary {
+    totalDuration: number;
+    averageDuration: number;
+    minDuration: number;
+    maxDuration: number;
+    count: number;
+    operationsPerSecond: number;
+}
+export declare class PerformanceMonitor {
+    private metrics;
+    private startTimes;
+    /**
+     * 开始计时
+     */
+    start(label: string): void;
+    /**
+     * 结束计时并记录
+     */
+    end(label: string, metadata?: Record<string, any>): number;
+    /**
+     * 获取统计信息
+     */
+    getSummary(label?: string): PerformanceSummary | Record<string, PerformanceSummary>;
+    /**
+     * 计算统计数据
+     */
+    private calculateSummary;
+    /**
+     * 获取原始指标
+     */
+    getMetrics(label?: string): PerformanceMetric[] | Record<string, PerformanceMetric[]>;
+    /**
+     * 清空指标
+     */
+    clear(label?: string): void;
+    /**
+     * 生成性能报告
+     */
+    generateReport(): string;
+}
+export declare const performanceMonitor: PerformanceMonitor;
+//# sourceMappingURL=PerformanceMonitor.d.ts.map