speccore 6.91.2 → 6.97.0

package/dist/core/usage-analytics.d.ts

@@ -0,0 +1,41 @@
+export type EventType = 'command' | 'task_start' | 'task_complete' | 'task_fail' | 'iteration_create' | 'spec_generate';
+export interface AnalyticsEvent {
+    type: EventType;
+    timestamp: string;
+    user: string;
+    command?: string;
+    task?: string;
+    iteration?: string;
+    durationMs?: number;
+    metadata?: Record<string, unknown>;
+}
+export interface UsageReport {
+    generatedAt: string;
+    user: string;
+    periodDays: number;
+    totalCommands: number;
+    commandFrequency: Record<string, number>;
+    totalTasks: number;
+    completedTasks: number;
+    failedTasks: number;
+    avgTaskDurationMin: number;
+    activeIterations: string[];
+    recommendations: string[];
+}
+/**
+ * 记录事件
+ */
+export declare function recordEvent(cwd: string, event: Omit<AnalyticsEvent, 'timestamp' | 'user'>): Promise<void>;
+/**
+ * 记录命令执行
+ */
+export declare function recordCommand(cwd: string, command: string, durationMs?: number): Promise<void>;
+/**
+ * 生成使用报告
+ */
+export declare function generateUsageReport(cwd: string, periodDays?: number): Promise<UsageReport>;
+/**
+ * 格式化报告为可读文本
+ */
+export declare function formatUsageReport(report: UsageReport): string;
+//# sourceMappingURL=usage-analytics.d.ts.map

package/dist/core/usage-analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-analytics.d.ts","sourceRoot":"","sources":["../../src/core/usage-analytics.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,YAAY,GAAG,eAAe,GAAG,WAAW,GAAG,kBAAkB,GAAG,eAAe,CAAC;AAExH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAMD;;GAEG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAa/G;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpG;AA0BD;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,SAAK,GAAG,OAAO,CAAC,WAAW,CAAC,CAqE5F;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAuC7D"}

package/dist/core/usage-analytics.js

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.recordEvent = recordEvent;
+exports.recordCommand = recordCommand;
+exports.generateUsageReport = generateUsageReport;
+exports.formatUsageReport = formatUsageReport;
+/**
+ * Usage Analytics — 使用模式分析
+ * v6.96.0: 记录命令使用频率、任务完成时间，输出使用报告
+ */
+const path_1 = require("path");
+const fs_extra_1 = require("fs-extra");
+const user_context_1 = require("./user-context");
+const ANALYTICS_DIR = '.speccore/local/analytics';
+const EVENT_LOG = 'events.jsonl';
+async function getAnalyticsPath(cwd) {
+    return (0, path_1.join)(cwd, ANALYTICS_DIR, EVENT_LOG);
+}
+/**
+ * 记录事件
+ */
+async function recordEvent(cwd, event) {
+    const dir = (0, path_1.join)(cwd, ANALYTICS_DIR);
+    await (0, fs_extra_1.ensureDir)(dir);
+    const fullEvent = {
+        ...event,
+        timestamp: new Date().toISOString(),
+        user: (0, user_context_1.getCurrentUser)(),
+    };
+    const logPath = await getAnalyticsPath(cwd);
+    const line = JSON.stringify(fullEvent) + '\n';
+    await (0, fs_extra_1.writeFile)(logPath, line, { flag: 'a' });
+}
+/**
+ * 记录命令执行
+ */
+async function recordCommand(cwd, command, durationMs) {
+    await recordEvent(cwd, { type: 'command', command, durationMs });
+}
+/**
+ * 加载所有事件
+ */
+async function loadEvents(cwd, maxAgeDays = 30) {
+    const logPath = await getAnalyticsPath(cwd);
+    if (!(await (0, fs_extra_1.pathExists)(logPath)))
+        return [];
+    const content = await (0, fs_extra_1.readFile)(logPath, 'utf-8');
+    const lines = content.split('\n').filter(Boolean);
+    const cutoff = Date.now() - maxAgeDays * 24 * 60 * 60 * 1000;
+    const events = [];
+    for (const line of lines) {
+        try {
+            const e = JSON.parse(line);
+            if (new Date(e.timestamp).getTime() >= cutoff) {
+                events.push(e);
+            }
+        }
+        catch { /* 忽略损坏行 */ }
+    }
+    return events;
+}
+/**
+ * 生成使用报告
+ */
+async function generateUsageReport(cwd, periodDays = 14) {
+    const events = await loadEvents(cwd, periodDays);
+    const commands = events.filter(e => e.type === 'command');
+    const commandFrequency = {};
+    for (const c of commands) {
+        const cmd = c.command || 'unknown';
+        commandFrequency[cmd] = (commandFrequency[cmd] || 0) + 1;
+    }
+    const taskStarts = events.filter(e => e.type === 'task_start');
+    const taskCompletes = events.filter(e => e.type === 'task_complete');
+    const taskFails = events.filter(e => e.type === 'task_fail');
+    // 计算平均任务耗时
+    let totalDuration = 0;
+    let durationCount = 0;
+    for (const tc of taskCompletes) {
+        if (tc.durationMs && tc.durationMs > 0) {
+            totalDuration += tc.durationMs;
+            durationCount++;
+        }
+    }
+    const avgTaskDurationMin = durationCount > 0
+        ? Math.round((totalDuration / durationCount / 60000) * 10) / 10
+        : 0;
+    const activeIterations = [...new Set(events.map(e => e.iteration).filter(Boolean))];
+    // 生成推荐
+    const recommendations = [];
+    if (taskCompletes.length === 0 && taskStarts.length > 0) {
+        recommendations.push('有进行中的任务但未记录完成，建议检查任务状态追踪');
+    }
+    if (!commandFrequency['code-index'] && !commandFrequency['ci']) {
+        recommendations.push('建议运行 speccore code-index --graph 构建代码知识图谱');
+    }
+    if ((commandFrequency['execute'] || 0) > 10 && (commandFrequency['doctor'] || 0) === 0) {
+        recommendations.push('执行频率较高，建议定期运行 speccore doctor 检查项目健康度');
+    }
+    if (taskFails.length > taskCompletes.length * 0.3) {
+        recommendations.push('任务失败率较高，建议运行 speccore analyze 重新评估需求');
+    }
+    if (activeIterations.length > 3) {
+        recommendations.push('活跃迭代较多，建议归档已完成的迭代');
+    }
+    if (recommendations.length === 0) {
+        recommendations.push('使用模式健康，继续保持！');
+    }
+    return {
+        generatedAt: new Date().toISOString(),
+        user: (0, user_context_1.getCurrentUser)(),
+        periodDays,
+        totalCommands: commands.length,
+        commandFrequency,
+        totalTasks: taskStarts.length,
+        completedTasks: taskCompletes.length,
+        failedTasks: taskFails.length,
+        avgTaskDurationMin,
+        activeIterations,
+        recommendations,
+    };
+}
+/**
+ * 格式化报告为可读文本
+ */
+function formatUsageReport(report) {
+    const lines = [];
+    lines.push('');
+    lines.push(`📊 使用模式报告（近 ${report.periodDays} 天）`);
+    lines.push('');
+    lines.push(`操作者: ${report.user}`);
+    lines.push(`总命令数: ${report.totalCommands}`);
+    lines.push(`任务完成: ${report.completedTasks} / ${report.totalTasks}（失败 ${report.failedTasks}）`);
+    if (report.avgTaskDurationMin > 0) {
+        lines.push(`平均任务耗时: ${report.avgTaskDurationMin} 分钟`);
+    }
+    lines.push('');
+    const topCommands = Object.entries(report.commandFrequency)
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 8);
+    if (topCommands.length > 0) {
+        lines.push('🔥 高频命令:');
+        for (const [cmd, count] of topCommands) {
+            lines.push(`   ${cmd}: ${count} 次`);
+        }
+        lines.push('');
+    }
+    if (report.activeIterations.length > 0) {
+        lines.push('📁 活跃迭代:');
+        for (const iter of report.activeIterations) {
+            lines.push(`   ${iter}`);
+        }
+        lines.push('');
+    }
+    lines.push('💡 智能推荐:');
+    for (const rec of report.recommendations) {
+        lines.push(`   • ${rec}`);
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+//# sourceMappingURL=usage-analytics.js.map

package/dist/core/usage-analytics.js.map

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

package/dist/core/user-context.d.ts

@@ -0,0 +1,9 @@
+/** 获取当前用户标识（git config → 环境变量 → 系统用户名） */
+export declare function getCurrentUser(): string;
+/** 设置当前用户（覆盖缓存） */
+export declare function setCurrentUser(user: string): void;
+/** 清除缓存（用于测试） */
+export declare function clearUserCache(): void;
+/** 获取用户标识的简短形式（用于文件名等） */
+export declare function getUserSlug(): string;
+//# sourceMappingURL=user-context.d.ts.map

package/dist/core/user-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-context.d.ts","sourceRoot":"","sources":["../../src/core/user-context.ts"],"names":[],"mappings":"AAQA,0CAA0C;AAC1C,wBAAgB,cAAc,IAAI,MAAM,CAuBvC;AAED,mBAAmB;AACnB,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED,iBAAiB;AACjB,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED,0BAA0B;AAC1B,wBAAgB,WAAW,IAAI,MAAM,CAMpC"}

package/dist/core/user-context.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCurrentUser = getCurrentUser;
+exports.setCurrentUser = setCurrentUser;
+exports.clearUserCache = clearUserCache;
+exports.getUserSlug = getUserSlug;
+/**
+ * User Context — 多用户支持
+ * v6.95.0: 识别当前操作者，记录操作日志
+ */
+const child_process_1 = require("child_process");
+let cachedUser;
+/** 获取当前用户标识（git config → 环境变量 → 系统用户名） */
+function getCurrentUser() {
+    if (cachedUser)
+        return cachedUser;
+    // 1. 环境变量
+    const envUser = process.env.SPECCORE_USER;
+    if (envUser) {
+        cachedUser = envUser;
+        return envUser;
+    }
+    // 2. git config user.name
+    try {
+        const gitName = (0, child_process_1.execSync)('git config user.name', { encoding: 'utf-8', timeout: 3000 }).trim();
+        if (gitName) {
+            cachedUser = gitName;
+            return gitName;
+        }
+    }
+    catch { /* 忽略 */ }
+    // 3. 系统用户名
+    const sysUser = process.env.USER || process.env.USERNAME || 'unknown';
+    cachedUser = sysUser;
+    return sysUser;
+}
+/** 设置当前用户（覆盖缓存） */
+function setCurrentUser(user) {
+    cachedUser = user;
+}
+/** 清除缓存（用于测试） */
+function clearUserCache() {
+    cachedUser = undefined;
+}
+/** 获取用户标识的简短形式（用于文件名等） */
+function getUserSlug() {
+    const user = getCurrentUser();
+    return user
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '');
+}
+//# sourceMappingURL=user-context.js.map

package/dist/core/user-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-context.js","sourceRoot":"","sources":["../../src/core/user-context.ts"],"names":[],"mappings":";;AASA,wCAuBC;AAGD,wCAEC;AAGD,wCAEC;AAGD,kCAMC;AAnDD;;;GAGG;AACH,iDAAyC;AAEzC,IAAI,UAA8B,CAAC;AAEnC,0CAA0C;AAC1C,SAAgB,cAAc;IAC5B,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC;IAElC,UAAU;IACV,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IAC1C,IAAI,OAAO,EAAE,CAAC;QACZ,UAAU,GAAG,OAAO,CAAC;QACrB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,0BAA0B;IAC1B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAA,wBAAQ,EAAC,sBAAsB,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9F,IAAI,OAAO,EAAE,CAAC;YACZ,UAAU,GAAG,OAAO,CAAC;YACrB,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC;IAEpB,WAAW;IACX,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,SAAS,CAAC;IACtE,UAAU,GAAG,OAAO,CAAC;IACrB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,mBAAmB;AACnB,SAAgB,cAAc,CAAC,IAAY;IACzC,UAAU,GAAG,IAAI,CAAC;AACpB,CAAC;AAED,iBAAiB;AACjB,SAAgB,cAAc;IAC5B,UAAU,GAAG,SAAS,CAAC;AACzB,CAAC;AAED,0BAA0B;AAC1B,SAAgB,WAAW;IACzB,MAAM,IAAI,GAAG,cAAc,EAAE,CAAC;IAC9B,OAAO,IAAI;SACR,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAC3B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "speccore",
-  "version": "6.91.2",
+  "version": "6.97.0",
   "description": "SpecCore - Code by Spec, Not by Vibe.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -44,7 +44,8 @@
     "@types/fs-extra": "^11.0.4",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^20.10.5",
-    "typescript": "^5.3.3"
+    "typescript": "^5.3.3",
+    "vitest": "^1.6.0"
   },
   "engines": {
     "node": ">=18.0.0"