speccore 4.6.1 → 4.8.0

package/dist/core/execution-state.js

@@ -0,0 +1,142 @@
+"use strict";
+/**
+ * Execution State — 执行状态追踪
+ *
+ * 管理分批执行的状态：批次划分、断点续传、进度记录
+ * 状态文件：.speccore/local/execution-state.json
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initExecutionState = initExecutionState;
+exports.loadExecutionState = loadExecutionState;
+exports.saveExecutionState = saveExecutionState;
+exports.completeBatch = completeBatch;
+exports.failTask = failTask;
+exports.clearExecutionState = clearExecutionState;
+exports.getCurrentBatchTasks = getCurrentBatchTasks;
+exports.canResume = canResume;
+const fs_extra_1 = require("fs-extra");
+const STATE_PATH = '.speccore/local/execution-state.json';
+/**
+ * 初始化执行状态
+ */
+function initExecutionState(tasks, iteration, batchSize = 3) {
+    const batches = chunkArray(tasks, batchSize);
+    const batchStatus = {};
+    batches.forEach((batch, i) => {
+        batchStatus[String(i + 1)] = {
+            status: i === 0 ? 'in_progress' : 'pending',
+            tasks: batch,
+        };
+    });
+    const state = {
+        iteration,
+        totalBatches: batches.length,
+        currentBatch: 1,
+        batchSize,
+        totalTasks: tasks.length,
+        completedTasks: [],
+        failedTasks: [],
+        pendingTasks: tasks.slice(),
+        batchStatus,
+        startedAt: new Date().toISOString(),
+        updatedAt: new Date().toISOString(),
+    };
+    saveExecutionState(state);
+    return state;
+}
+/**
+ * 加载执行状态
+ */
+function loadExecutionState() {
+    try {
+        if (!(0, fs_extra_1.existsSync)(STATE_PATH))
+            return null;
+        const raw = (0, fs_extra_1.readFileSync)(STATE_PATH, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 保存执行状态
+ */
+function saveExecutionState(state) {
+    state.updatedAt = new Date().toISOString();
+    (0, fs_extra_1.ensureFileSync)(STATE_PATH);
+    (0, fs_extra_1.writeFileSync)(STATE_PATH, JSON.stringify(state, null, 2));
+}
+/**
+ * 标记批次完成
+ */
+function completeBatch(state, batchNum, completedTasks) {
+    const batch = state.batchStatus[String(batchNum)];
+    if (batch) {
+        batch.status = 'completed';
+        batch.completedAt = new Date().toISOString();
+    }
+    state.completedTasks.push(...completedTasks);
+    state.pendingTasks = state.pendingTasks.filter((t) => !completedTasks.includes(t));
+    // 移动到下一个批次
+    const nextBatch = batchNum + 1;
+    if (state.batchStatus[String(nextBatch)]) {
+        state.currentBatch = nextBatch;
+        state.batchStatus[String(nextBatch)].status = 'in_progress';
+        state.batchStatus[String(nextBatch)].startedAt = new Date().toISOString();
+    }
+    saveExecutionState(state);
+    return state;
+}
+/**
+ * 标记任务失败
+ */
+function failTask(state, taskId) {
+    if (!state.failedTasks.includes(taskId)) {
+        state.failedTasks.push(taskId);
+    }
+    state.pendingTasks = state.pendingTasks.filter((t) => t !== taskId);
+    saveExecutionState(state);
+    return state;
+}
+/**
+ * 清除执行状态（完成或取消后）
+ */
+function clearExecutionState() {
+    try {
+        if ((0, fs_extra_1.existsSync)(STATE_PATH)) {
+            const { unlinkSync } = require('fs');
+            unlinkSync(STATE_PATH);
+        }
+    }
+    catch { }
+}
+/**
+ * 获取当前批次的任务列表
+ */
+function getCurrentBatchTasks(state) {
+    const batch = state.batchStatus[String(state.currentBatch)];
+    return batch?.tasks || [];
+}
+/**
+ * 检查是否有断点可恢复
+ */
+function canResume() {
+    const state = loadExecutionState();
+    if (!state)
+        return false;
+    // 检查是否有未完成的批次
+    for (const [key, batch] of Object.entries(state.batchStatus)) {
+        if (batch.status === 'pending' || batch.status === 'in_progress') {
+            return true;
+        }
+    }
+    return false;
+}
+function chunkArray(arr, size) {
+    const chunks = [];
+    for (let i = 0; i < arr.length; i += size) {
+        chunks.push(arr.slice(i, i + size));
+    }
+    return chunks;
+}
+//# sourceMappingURL=execution-state.js.map

package/dist/core/execution-state.js.map

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

package/dist/core/git-integration.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Git Integration — 任务与 Git 工作流深度整合
+ *
+ * 功能：
+ *  - 任务 ↔ 分支关联
+ *  - Commit 消息自动生成
+ *  - PR 描述自动生成
+ *  - Git Hook 安装
+ */
+/**
+ * 为任务创建 Git 分支
+ */
+export declare function createTaskBranch(taskId: string, taskName: string): string | null;
+/**
+ * 获取当前分支关联的任务
+ */
+export declare function getCurrentTaskMapping(): {
+    taskId: string;
+    taskName: string;
+} | null;
+/**
+ * 生成 Commit 消息
+ */
+export declare function generateCommitMessage(taskId: string, taskName: string, specs?: string[]): string;
+/**
+ * 生成 PR 描述
+ */
+export declare function generatePRDescription(taskId: string, taskName: string): string;
+/**
+ * 安装 Git Hooks
+ */
+export declare function installGitHooks(): {
+    preCommit: boolean;
+    prePush: boolean;
+};
+//# sourceMappingURL=git-integration.d.ts.map

package/dist/core/git-integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-integration.d.ts","sourceRoot":"","sources":["../../src/core/git-integration.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgBH;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgBhF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAQnF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAchG;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAmB9E;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAyB1E"}

package/dist/core/git-integration.js

@@ -0,0 +1,139 @@
+"use strict";
+/**
+ * Git Integration — 任务与 Git 工作流深度整合
+ *
+ * 功能：
+ *  - 任务 ↔ 分支关联
+ *  - Commit 消息自动生成
+ *  - PR 描述自动生成
+ *  - Git Hook 安装
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTaskBranch = createTaskBranch;
+exports.getCurrentTaskMapping = getCurrentTaskMapping;
+exports.generateCommitMessage = generateCommitMessage;
+exports.generatePRDescription = generatePRDescription;
+exports.installGitHooks = installGitHooks;
+const fs_extra_1 = require("fs-extra");
+const path_1 = require("path");
+const child_process_1 = require("child_process");
+const GIT_MAPPING_PATH = '.speccore/.git-mapping.json';
+/**
+ * 为任务创建 Git 分支
+ */
+function createTaskBranch(taskId, taskName) {
+    try {
+        const safeName = taskName.replace(/[^\w\u4e00-\u9fa5-]/g, '-').replace(/-+/g, '-');
+        const branchName = `feature/${taskId}-${safeName}`.substring(0, 100);
+        (0, child_process_1.execSync)(`git checkout -b "${branchName}"`, { stdio: 'pipe' });
+        // 记录关联
+        const mapping = loadMapping();
+        mapping[branchName] = { taskId, taskName: taskName, createdAt: new Date().toISOString() };
+        saveMapping(mapping);
+        return branchName;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 获取当前分支关联的任务
+ */
+function getCurrentTaskMapping() {
+    try {
+        const branch = (0, child_process_1.execSync)('git branch --show-current', { encoding: 'utf-8', stdio: 'pipe' }).trim();
+        const mapping = loadMapping();
+        return mapping[branch] || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 生成 Commit 消息
+ */
+function generateCommitMessage(taskId, taskName, specs) {
+    const lines = [`feat(${taskId}): ${taskName}`, ''];
+    const changed = getChangedFiles();
+    if (changed.length > 0) {
+        lines.push('变更文件:');
+        for (const f of changed.slice(0, 10)) {
+            lines.push(`  - ${f}`);
+        }
+        lines.push('');
+    }
+    lines.push(`关联 Spec: ${taskId}`);
+    return lines.join('\n');
+}
+/**
+ * 生成 PR 描述
+ */
+function generatePRDescription(taskId, taskName) {
+    const taskDir = (0, path_1.join)(process.cwd(), `.speccore`);
+    const lines = [
+        `## 关联任务`,
+        `- ${taskId} ${taskName}`,
+        '',
+        '## 变更内容',
+        ...getChangedFiles().map((f) => `- [ ] ${f}`),
+        '',
+        '## 验收标准',
+        '- [ ] AC-01: 功能正常',
+        '- [ ] AC-02: 边界处理',
+        '',
+        '## 测试',
+        '- 通过 `speccore validate` 校验',
+        '',
+        `关联 Spec: ${taskId}`,
+    ];
+    return lines.join('\n');
+}
+/**
+ * 安装 Git Hooks
+ */
+function installGitHooks() {
+    const gitDir = (0, path_1.join)(process.cwd(), '.git');
+    if (!(0, fs_extra_1.existsSync)(gitDir)) {
+        throw new Error('Not a Git repository');
+    }
+    const hooksDir = (0, path_1.join)(gitDir, 'hooks');
+    // pre-commit: check spec annotations
+    const preCommitContent = `#!/bin/sh
+# SpecCore pre-commit hook
+echo "🔍 SpecCore: Checking @spec annotations..."
+git diff --cached --name-only | grep -q "@spec" && echo "✅ Spec annotations found" || true
+`;
+    (0, fs_extra_1.writeFileSync)((0, path_1.join)(hooksDir, 'pre-commit'), preCommitContent, { mode: 0o755 });
+    // pre-push: run validate
+    const prePushContent = `#!/bin/sh
+# SpecCore pre-push hook
+echo "🔍 SpecCore: Validating specs..."
+speccore validate --warn-only
+`;
+    (0, fs_extra_1.writeFileSync)((0, path_1.join)(hooksDir, 'pre-push'), prePushContent, { mode: 0o755 });
+    return { preCommit: true, prePush: true };
+}
+// === Helpers ===
+function loadMapping() {
+    try {
+        if ((0, fs_extra_1.existsSync)(GIT_MAPPING_PATH)) {
+            return JSON.parse((0, fs_extra_1.readFileSync)(GIT_MAPPING_PATH, 'utf-8'));
+        }
+    }
+    catch { }
+    return {};
+}
+function saveMapping(mapping) {
+    (0, fs_extra_1.ensureFileSync)(GIT_MAPPING_PATH);
+    (0, fs_extra_1.writeFileSync)(GIT_MAPPING_PATH, JSON.stringify(mapping, null, 2));
+}
+function getChangedFiles() {
+    try {
+        const output = (0, child_process_1.execSync)('git diff --name-only HEAD', { encoding: 'utf-8', stdio: 'pipe' });
+        return output.trim().split('\n').filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=git-integration.js.map

package/dist/core/git-integration.js.map

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

package/dist/core/operation-log.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Operation Log — 操作日志记录
+ *
+ * 记录所有关键操作到 .speccore/logs/YYYY-MM-DD.log
+ * 格式: [时间] 用户 命令 参数
+ */
+/**
+ * 记录操作日志
+ */
+export declare function logOperation(command: string, detail?: string): void;
+/**
+ * 记录命令执行（不带详情）
+ */
+export declare function logCommand(command: string[]): void;
+//# sourceMappingURL=operation-log.d.ts.map

package/dist/core/operation-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-log.d.ts","sourceRoot":"","sources":["../../src/core/operation-log.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAanE;AAkBD;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAElD"}

package/dist/core/operation-log.js

@@ -0,0 +1,88 @@
+"use strict";
+/**
+ * Operation Log — 操作日志记录
+ *
+ * 记录所有关键操作到 .speccore/logs/YYYY-MM-DD.log
+ * 格式: [时间] 用户 命令 参数
+ */
+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.logOperation = logOperation;
+exports.logCommand = logCommand;
+const fs_extra_1 = require("fs-extra");
+const path_1 = require("path");
+const os = __importStar(require("os"));
+const getLogDir = () => (0, path_1.join)(process.cwd(), '.speccore', 'logs');
+/**
+ * 记录操作日志
+ */
+function logOperation(command, detail) {
+    const now = new Date().toISOString().replace('T', ' ').substring(0, 19);
+    const user = getUserName();
+    const logDir = getLogDir();
+    const logFile = (0, path_1.join)(logDir, `${now.substring(0, 10)}.log`);
+    try {
+        (0, fs_extra_1.ensureFileSync)(logFile);
+        const line = `[${now}] ${user} ${command}${detail ? ` | ${detail}` : ''}`;
+        (0, fs_extra_1.appendFileSync)(logFile, line + '\n');
+    }
+    catch {
+        // 日志写入失败不影响主流程
+    }
+}
+/**
+ * 获取用户名（git config 优先）
+ */
+function getUserName() {
+    try {
+        const { execSync } = require('child_process');
+        return execSync('git config user.name', { encoding: 'utf-8' }).trim() || 'unknown';
+    }
+    catch {
+        try {
+            return os.userInfo().username || 'unknown';
+        }
+        catch {
+            return 'unknown';
+        }
+    }
+}
+/**
+ * 记录命令执行（不带详情）
+ */
+function logCommand(command) {
+    logOperation(command.join(' '));
+}
+//# sourceMappingURL=operation-log.js.map

package/dist/core/operation-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-log.js","sourceRoot":"","sources":["../../src/core/operation-log.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAWH,oCAaC;AAqBD,gCAEC;AA7CD,uCAA0D;AAC1D,+BAA4B;AAC5B,uCAAyB;AAEzB,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,IAAA,WAAI,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;AAEjE;;GAEG;AACH,SAAgB,YAAY,CAAC,OAAe,EAAE,MAAe;IAC3D,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACxE,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,IAAA,WAAI,EAAC,MAAM,EAAE,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;IAE5D,IAAI,CAAC;QACH,IAAA,yBAAc,EAAC,OAAO,CAAC,CAAC;QACxB,MAAM,IAAI,GAAG,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC1E,IAAA,yBAAc,EAAC,OAAO,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,WAAW;IAClB,IAAI,CAAC;QACH,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;QAC9C,OAAO,QAAQ,CAAC,sBAAsB,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC;IACrF,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,CAAC;YACH,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,IAAI,SAAS,CAAC;QAC7C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,UAAU,CAAC,OAAiB;IAC1C,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAClC,CAAC"}

package/dist/core/task-lock.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Task Lock — 远程协作锁机制
+ *
+ * 防止多人同时修改同一个 Task
+ * 锁文件：.speccore/.locks/{taskId}.lock
+ */
+interface LockData {
+    taskId: string;
+    holder: string;
+    operation: string;
+    acquiredAt: string;
+    expiresAt: string;
+}
+/**
+ * 获取锁（如果可用）
+ */
+export declare function acquireLock(taskId: string, operation: string): {
+    holder: string;
+    acquiredAt: string;
+} | null;
+/**
+ * 释放锁
+ */
+export declare function releaseLock(taskId: string): void;
+/**
+ * 检查锁状态
+ */
+export declare function checkLock(taskId: string): LockData | null;
+export {};
+//# sourceMappingURL=task-lock.d.ts.map

package/dist/core/task-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-lock.d.ts","sourceRoot":"","sources":["../../src/core/task-lock.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,UAAU,QAAQ;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAkBD;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA+B5G;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAKhD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAczD"}

package/dist/core/task-lock.js

@@ -0,0 +1,94 @@
+"use strict";
+/**
+ * Task Lock — 远程协作锁机制
+ *
+ * 防止多人同时修改同一个 Task
+ * 锁文件：.speccore/.locks/{taskId}.lock
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.acquireLock = acquireLock;
+exports.releaseLock = releaseLock;
+exports.checkLock = checkLock;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const LOCKS_DIR = '.speccore/.locks';
+const LOCK_TIMEOUT_MINUTES = 30;
+function getLockPath(taskId) {
+    return (0, path_1.join)(LOCKS_DIR, `${taskId}.lock`);
+}
+function getUser() {
+    try {
+        const { execSync } = require('child_process');
+        return execSync('git config user.name', { encoding: 'utf-8', stdio: 'pipe' }).trim() || 'unknown';
+    }
+    catch {
+        return 'unknown';
+    }
+}
+/**
+ * 获取锁（如果可用）
+ */
+function acquireLock(taskId, operation) {
+    ensureLocksDir();
+    const lockPath = getLockPath(taskId);
+    // 检查已有锁
+    if ((0, fs_1.existsSync)(lockPath)) {
+        try {
+            const existing = JSON.parse((0, fs_1.readFileSync)(lockPath, 'utf-8'));
+            const expired = Date.now() > new Date(existing.expiresAt).getTime();
+            if (!expired) {
+                return { holder: existing.holder, acquiredAt: existing.acquiredAt };
+            }
+            // 过期锁，删除
+            (0, fs_1.unlinkSync)(lockPath);
+        }
+        catch {
+            (0, fs_1.unlinkSync)(lockPath);
+        }
+    }
+    // 创建新锁
+    const user = getUser();
+    const data = {
+        taskId,
+        holder: user,
+        operation,
+        acquiredAt: new Date().toISOString(),
+        expiresAt: new Date(Date.now() + LOCK_TIMEOUT_MINUTES * 60 * 1000).toISOString(),
+    };
+    (0, fs_1.writeFileSync)(lockPath, JSON.stringify(data, null, 2));
+    return null; // 锁获取成功，返回 null 表示无冲突
+}
+/**
+ * 释放锁
+ */
+function releaseLock(taskId) {
+    const lockPath = getLockPath(taskId);
+    if ((0, fs_1.existsSync)(lockPath)) {
+        (0, fs_1.unlinkSync)(lockPath);
+    }
+}
+/**
+ * 检查锁状态
+ */
+function checkLock(taskId) {
+    const lockPath = getLockPath(taskId);
+    if (!(0, fs_1.existsSync)(lockPath))
+        return null;
+    try {
+        const data = JSON.parse((0, fs_1.readFileSync)(lockPath, 'utf-8'));
+        if (Date.now() > new Date(data.expiresAt).getTime()) {
+            (0, fs_1.unlinkSync)(lockPath);
+            return null;
+        }
+        return data;
+    }
+    catch {
+        return null;
+    }
+}
+function ensureLocksDir() {
+    if (!(0, fs_1.existsSync)(LOCKS_DIR)) {
+        (0, fs_1.mkdirSync)(LOCKS_DIR, { recursive: true });
+    }
+}
+//# sourceMappingURL=task-lock.js.map

package/dist/core/task-lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-lock.js","sourceRoot":"","sources":["../../src/core/task-lock.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAgCH,kCA+BC;AAKD,kCAKC;AAKD,8BAcC;AA1FD,2BAAoF;AACpF,+BAA4B;AAU5B,MAAM,SAAS,GAAG,kBAAkB,CAAC;AACrC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEhC,SAAS,WAAW,CAAC,MAAc;IACjC,OAAO,IAAA,WAAI,EAAC,SAAS,EAAE,GAAG,MAAM,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,OAAO;IACd,IAAI,CAAC;QACH,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;QAC9C,OAAO,QAAQ,CAAC,sBAAsB,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC;IACpG,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW,CAAC,MAAc,EAAE,SAAiB;IAC3D,cAAc,EAAE,CAAC;IACjB,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IAErC,QAAQ;IACR,IAAI,IAAA,eAAU,EAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAa,IAAI,CAAC,KAAK,CAAC,IAAA,iBAAY,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;YACvE,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;YACpE,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,CAAC;YACtE,CAAC;YACD,SAAS;YACT,IAAA,eAAU,EAAC,QAAQ,CAAC,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,IAAA,eAAU,EAAC,QAAQ,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO;IACP,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IACvB,MAAM,IAAI,GAAa;QACrB,MAAM;QACN,MAAM,EAAE,IAAI;QACZ,SAAS;QACT,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACpC,SAAS,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,oBAAoB,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE;KACjF,CAAC;IAEF,IAAA,kBAAa,EAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACvD,OAAO,IAAI,CAAC,CAAC,sBAAsB;AACrC,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW,CAAC,MAAc;IACxC,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,IAAA,eAAU,EAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,IAAA,eAAU,EAAC,QAAQ,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,SAAS,CAAC,MAAc;IACtC,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,CAAC,IAAA,eAAU,EAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAEvC,IAAI,CAAC;QACH,MAAM,IAAI,GAAa,IAAI,CAAC,KAAK,CAAC,IAAA,iBAAY,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;QACnE,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;YACpD,IAAA,eAAU,EAAC,QAAQ,CAAC,CAAC;YACrB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,cAAc;IACrB,IAAI,CAAC,IAAA,eAAU,EAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,IAAA,cAAS,EAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "speccore",
-  "version": "4.6.1",
+  "version": "4.8.0",
   "description": "SpecCore - Code by Spec, Not by Vibe.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",